Επιλογές tsconfigExplained

55 of 55 rows

Επιλογή↕	Τι ελέγχει↕
Αυστηρότητα
⤢strict	Γενικός διακόπτης: ενεργοποιεί τα strictNullChecks, noImplicitAny και αρκετά άλλα μαζί.
⤢noImplicitAny	Σφάλμα σε παραμέτρους και μεταβλητές των οποίων ο τύπος δεν μπορεί να συναχθεί (αλλιώς θα ήταν any).
⤢strictNullChecks	Τα null και undefined δεν αναθέτονται πλέον σε κάθε τύπο· γίνονται δεκτά μόνο ρητά.
⤢strictFunctionTypes	Ελέγχει τις παραμέτρους συναρτήσεων με αντίστροφη διακύμανση· εντοπίζει μη ασφαλείς τύπους παραμέτρων σε callbacks.
⤢strictBindCallApply	Ελέγχει τυπικά τα bind, call και apply ως προς τις δηλωμένες παραμέτρους της συνάρτησης.
⤢strictPropertyInitialization	Σφάλμα όταν μια ιδιότητα κλάσης δεν έχει αρχική τιμή και δεν αναθέτεται στον constructor.
⤢exactOptionalPropertyTypes	Μια προαιρετική ιδιότητα { p?: T } δεν δέχεται πλέον ρητή ανάθεση undefined.
⤢noImplicitOverride	Απαιτεί τη λέξη-κλειδί override σε μέλη που σκιάζουν μέλος της βασικής κλάσης.
⤢noUnusedLocals	Σφάλμα σε δηλωμένες τοπικές μεταβλητές που δεν διαβάζονται ποτέ.
⤢noUnusedParameters	Σφάλμα σε δηλωμένες παραμέτρους συναρτήσεων που δεν διαβάζονται ποτέ.
⤢noUnusedExpressions	Σφάλμα σε προτάσεις-εκφράσεις χωρίς αποτέλεσμα.
⤢noPropertyAccessFromIndexSignature	Η πρόσβαση με τελεία απαγορεύεται για κλειδιά index signature· χρησιμοποιήστε αγκύλες (obj["key"]).
⤢noImplicitReturns	Σφάλμα όταν μια διαδρομή κώδικα επιστρέφει τιμή αλλά μια άλλη όχι.
⤢noFallthroughCasesInSwitch	Σφάλμα όταν ένα case περνά στο επόμενο χωρίς break.
Γλώσσα και modules
⤢target	Το επίπεδο παραγωγής JavaScript (π.χ. ES2022)· νεότεροι στόχοι σημαίνουν λιγότερο downleveling.
⤢lib	Τα ενσωματωμένα API που είναι διαθέσιμα (π.χ. ES2022, DOM, DOM.Iterable).
⤢module	Το σύστημα modules που παράγεται (π.χ. ESNext, CommonJS, NodeNext).
⤢module: nodenext	Ακολουθεί τους πραγματικούς κανόνες του Node: κάθε αρχείο επιλέγει CJS ή ESM από το κοντινότερο package.json, και τα σχετικά imports χρειάζονται επεκτάσεις αρχείων.
⤢moduleResolution	Πώς επιλύονται οι διαδρομές import (π.χ. bundler, node, nodenext).
⤢moduleDetection	Πότε ένα αρχείο μετράει ως module: auto (κατά την ύπαρξη import/export), legacy ή force (πάντα).
⤢esModuleInterop	Επιτρέπει στυλ default import από modules CommonJS (προεπιλογή true στα περισσότερα setups).
⤢allowSyntheticDefaultImports	Επιτρέπει default imports από modules που εξάγουν μόνο επώνυμες τιμές (μόνο σε επίπεδο τύπων).
⤢verbatimModuleSyntax	Τα imports παράγονται ακριβώς όπως γράφτηκαν· τα imports μόνο τύπων πρέπει να χρησιμοποιούν import type (TS 5).
⤢resolveJsonModule	Επιτρέπει στα imports να φορτώνουν αρχεία .json ως τυποποιημένες τιμές.
⤢allowJs	Συμπεριλαμβάνει αρχεία .js ως είσοδο στη μεταγλώττιση.
⤢checkJs	Ελέγχει τυπικά και τα αρχεία .js, διαβάζοντας τα σχόλια JSDoc τους· συνεπάγεται το allowJs.
⤢jsx	Πώς μεταγλωττίζεται το .tsx: react-jsx (αυτόματο runtime), react (React.createElement) ή preserve.
⤢types	Περιορίζει τα αυτόματα συμπεριλαμβανόμενα πακέτα @types σε αυτή τη λίστα· ένα κενό array δεν περιλαμβάνει κανένα.
⤢typeRoots	Φάκελοι που σαρώνονται για πακέτα @types αντί για κάθε node_modules/@types πιο πάνω στο δέντρο.
⤢isolatedModules	Διασφαλίζει ότι κάθε αρχείο μπορεί να μεταγλωττιστεί απομονωμένα (απαιτείται από bundlers και esbuild).
Παραγωγή κώδικα
⤢outDir	Πού γράφεται το μεταγλωττισμένο JavaScript.
⤢rootDir	Η ρίζα των αρχείων πηγής· κρατά σταθερό το σχήμα του δέντρου εξόδου.
⤢sourceMap	Παράγει αρχεία .js.map ώστε οι debuggers να αντιστοιχίζουν πίσω στο TypeScript.
⤢inlineSourceMap	Ενσωματώνει το source map ως σχόλιο μέσα στο αρχείο .js αντί για αρχείο .js.map.
⤢declaration	Παράγει δηλώσεις τύπων .d.ts (απαραίτητο για βιβλιοθήκες).
⤢declarationMap	Παράγει αρχεία .d.ts.map ώστε οι editors να μεταπηδούν από τις δηλώσεις πίσω στην πηγή TypeScript.
⤢emitDeclarationOnly	Παράγει μόνο αρχεία .d.ts· το JavaScript μένει σε bundler (απαιτεί declaration ή composite).
⤢importHelpers	Επαναχρησιμοποιεί βοηθητικά όπως το __rest από το tslib αντί να τα παράγει σε κάθε αρχείο.
⤢downlevelIteration	Διορθώνει for..of, spread και destructuring πάνω σε iterables όταν το target προηγείται του ES2015.
⤢removeComments	Αφαιρεί τα σχόλια από το παραγόμενο JavaScript.
⤢noEmit	Μόνο έλεγχος τύπων· δεν γράφει αρχεία (χρησιμοποιείται όταν ένα bundler αναλαμβάνει την παραγωγή).
Διαδρομές
⤢baseUrl	Ένας βασικός φάκελος για την επίλυση μη σχετικών modules.
⤢paths	Χαρτογραφεί προθέματα import σε τοποθεσίες, π.χ. { "@/*": ["src/*"] }.
⤢rootDirs	Αντιμετωπίζει πολλούς φακέλους ως μία εικονική ρίζα για την επίλυση.
Δομή project
⤢composite	Χαρακτηρίζει το project ως κατάλληλο για build ώστε να χρησιμοποιηθεί σε project references (ενεργοποιεί declaration, incremental).
⤢references	Εξαρτάται από άλλα projects tsconfig για γρηγορότερα, απομονωμένα builds.
⤢incremental	Αποθηκεύει πληροφορίες build για να παραλείπει τα αμετάβλητα αρχεία στην επόμενη εκτέλεση.
Άλλοι έλεγχοι
⤢skipLibCheck	Παραλείπει τον έλεγχο τύπων των αρχείων .d.ts για ταχύτητα (προεπιλογή true).
⤢forceConsistentCasingInFileNames	Σφάλμα σε imports που διαφωνούν με τα πραγματικά κεφαλαία/πεζά του ονόματος του αρχείου.
⤢noUncheckedIndexedAccess	Η πρόσβαση σε πίνακες και ευρετήρια επιστρέφει T | undefined, όχι T.
⤢useDefineForClassFields	Τα πεδία κλάσεων δημιουργούνται με Object.defineProperty αντί για απλή ανάθεση (προεπιλογή true για targets ES2022+).
⤢experimentalDecorators	Ενεργοποιεί την παλιά σύνταξη decorators που χρησιμοποιούν παλαιότερα frameworks (προ του προτύπου).
⤢noErrorTruncation	Αναφέρει ολόκληρα ονόματα τύπων στα μηνύματα σφάλματος αντί να περικόπτει τα μακριά.
⤢noUncheckedSideEffectImports	Σφάλμα όταν ένα καθαρά side-effect import (import "./x.css") δεν επιλύεται σε τίποτα.
⤢allowImportingTsExtensions	Επιτρέπει διαδρομές import που τελειώνουν σε .ts (απαιτεί noEmit ή emitDeclarationOnly).