feat(EntryFilesAnalyzer): add option to ignore entry file that doesn not exist (#320)

Author: clemgbld

docs/api/EntryFilesAnalyser.md

@@ -22,6 +22,7 @@ interface EntryFilesAnalyserOptions {
   astAnalyzer?: AstAnalyser;
   loadExtensions?: (defaults: string[]) => string[];
   rootPath?: string | URL;
+  ignoreENOENT?: boolean;
 }
 ```
 

src/EntryFilesAnalyser.js

@@ -19,7 +19,8 @@ export class EntryFilesAnalyser {
     const {
       astAnalyzer = new AstAnalyser(),
       loadExtensions,
-      rootPath = null
+      rootPath = null,
+      ignoreENOENT = false
     } = options;
 
     this.astAnalyzer = astAnalyzer;
@@ -30,6 +31,7 @@ export class EntryFilesAnalyser {
     this.allowedExtensions = new Set(rawAllowedExtensions);
     this.#rootPath = options.rootPath === null ?
       null : fileURLToPathExtended(rootPath);
+    this.ignoreENOENT = ignoreENOENT;
   }
 
   async* analyse(
@@ -43,6 +45,10 @@ export class EntryFilesAnalyser {
         fileURLToPathExtended(entryFile)
       );
 
+      if (this.ignoreENOENT && !await this.#fileExists(normalizedEntryFile)) {
+        return;
+      }
+
       yield* this.#analyseFile(
         normalizedEntryFile,
         this.#getRelativeFilePath(normalizedEntryFile),

test/EntryFilesAnalyser.spec.js

@@ -183,6 +183,23 @@ describe("EntryFilesAnalyser", () => {
   });
 });
 
+it("should ignore file that does not exist when option ignoreENOENT is provided", async() => {
+  const entryFilesAnalyser = new EntryFilesAnalyser({
+    ignoreENOENT: true,
+    rootPath: FIXTURE_URL
+  });
+
+  const entryUrl = new URL("does-not-exists.js", FIXTURE_URL);
+
+  const generator = entryFilesAnalyser.analyse(
+    [entryUrl]
+  );
+
+  const reports = await fromAsync(generator);
+  assert.strictEqual(reports.length, 0);
+  assert.strictEqual(entryFilesAnalyser.dependencies.hasVertex("does-not-exists.js"), false);
+});
+
 // TODO: replace with Array.fromAsync when droping Node.js 20
 async function fromAsync(asyncIter) {
   const items = [];

types/api.d.ts

@@ -145,6 +145,7 @@ interface EntryFilesAnalyserOptions {
   astAnalyzer?: AstAnalyser;
   loadExtensions?: (defaults: string[]) => string[];
   rootPath?: string | URL;
+  ignoreENOENT?: boolean;
 }
 
 declare class EntryFilesAnalyser {