–listFilesOnly în TypeScript

tsc --listFilesOnly
tsc --listFiles

Ce face --listFilesOnly

--listFilesOnly afișează lista completă de fișiere din program (inclusiv bibliotecile standard lib.*.d.ts și pachetele de tipuri) și se oprește, fără verificare și fără emitere. Este util când vrei să știi dacă un fișier a fost inclus sau de ce compilarea citește atât de multe fișiere.

--listFiles face compilarea normală (cu erori și fișiere generate) și afișează la final aceeași listă. Pentru motivul pentru care fiecare fișier a fost inclus, folosește --explainFiles.

Parametri

Parametru	Descriere
--listFilesOnly	Doar lista, fără compilare (doar în linia de comandă).
--listFiles	Compilare plus lista. Implicit false.

Exemple

Exemplul 1: Lista fișierelor din program

Cu lib: ["es2022"] și types: [], programul are 57 de fișiere de bibliotecă plus cele două fișiere ale proiectului (lista de mai jos este prescurtată, iar căile din node_modules sunt scurtate).

// tsconfig.json
{
  "compilerOptions": {
    "module": "nodenext",
    "target": "es2022",
    "noEmit": true,
    "lib": ["es2022"],
    "types": []
  }
}

// index.ts
import { a } from "./a.js";
console.log(a);

Rezultat (tsc 5.9)

$ npx tsc --listFilesOnly | wc -l
      59

$ npx tsc --listFilesOnly
node_modules/typescript/lib/lib.es5.d.ts
node_modules/typescript/lib/lib.es2015.d.ts
...
node_modules/typescript/lib/lib.decorators.d.ts
node_modules/typescript/lib/lib.decorators.legacy.d.ts
/proiect/a.ts
/proiect/index.ts

Greșeli frecvente

• Să folosești --listFiles doar ca să vezi lista, într-un proiect mare. --listFilesOnly este mult mai rapid: nu verifică tipurile.

Comenzi înrudite

• explainFiles: Afișează fiecare fișier din compilare și motivul pentru care a fost inclus (include, import, lib, types).
• listEmittedFiles: Afișează căile fișierelor scrise de tsc la compilare (.js, .d.ts, .map), fiecare cu prefixul TSFILE:.
• --showConfig: Afișează configurația finală (cu extends rezolvat și opțiunile deduse) și lista de fișiere, fără să compileze.
• types: Alege exact ce pachete de tipuri globale (din node_modules/@types) se încarcă automat; [] nu încarcă niciunul.