tsconfig beállításokExplained

55 of 55 rows

Beállítás↕	Mit szabályoz↕
Szigorság
⤢strict	Főkapcsoló: egyszerre bekapcsolja a strictNullChecks, noImplicitAny és több más beállítást.
⤢noImplicitAny	Hibát jelez azoknál a paramétereken és változóknál, amelyek típusa nem következtethető ki (különben any lenne).
⤢strictNullChecks	A null és az undefined már nem rendelhető minden típushoz; kifejezetten kell vállalnod.
⤢strictFunctionTypes	A függvényparamétereket kontravariánsan ellenőrzi; kiszűri a hangtalan callback-paramétertípusokat.
⤢strictBindCallApply	A bind, call és apply típusellenőrzése a függvény deklarált paraméterei szerint.
⤢strictPropertyInitialization	Hibát jelez, ha egy osztályattribútumnak nincs kezdőértéke, és a konstruktorban sem kap értéket.
⤢exactOptionalPropertyTypes	Egy opcionális { p?: T } attribútum már nem fogad el kifejezett undefined értékadást.
⤢noImplicitOverride	Megköveteli az override kulcsszót az olyan tagokon, amelyek elfednek egy alaposztálybeli tagot.
⤢noUnusedLocals	Hibát jelez a soha nem olvasott, deklarált helyi változókra.
⤢noUnusedParameters	Hibát jelez a soha nem olvasott, deklarált függvényparaméterekre.
⤢noUnusedExpressions	Hibát jelez az olyan kifejezés-utasításokra, amelyeknek nincs hatásuk.
⤢noPropertyAccessFromIndexSignature	Az index-szignatúra kulcsainál nem engedélyezett a pont-hozzáférés; használj szögletes zárójelet (obj["key"]).
⤢noImplicitReturns	Hibát jelez, ha egy kódútvonal értéket ad vissza, egy másik viszont nem.
⤢noFallthroughCasesInSwitch	Hibát jelez, ha egy switch-ág break nélkül esik át a következőbe.
Nyelv és modulok
⤢target	A JavaScript-generálás szintje (pl. ES2022); újabb targeteknél kevesebb visszaalakítás (downleveling) történik.
⤢lib	Az elérhető beépített API-k (pl. ES2022, DOM, DOM.Iterable).
⤢module	A kibocsátott modulrendszer (pl. ESNext, CommonJS, NodeNext).
⤢module: nodenext	A Node valódi szabályait használja: minden fájl a legközelebbi package.json alapján választ CJS vagy ESM közül, és a relatív importokhoz fájlkiterjesztés kell.
⤢moduleResolution	Az importútvonalak feloldásának módja (pl. bundler, node, nodenext).
⤢moduleDetection	Mikor számít egy fájl modulnak: auto (import/export jelenléte szerint), legacy vagy force (mindig).
⤢esModuleInterop	Lehetővé teszi a default-import stílust CommonJS-modulokból (a legtöbb beállításban alapból true).
⤢allowSyntheticDefaultImports	Lehetővé teszi a default importot olyan modulokból, amelyek csak névvel exportálnak (csak típusszinten).
⤢verbatimModuleSyntax	Az importok pontosan úgy íródnak ki, ahogy meg vannak írva; a csak típusú importoknak import type-ot kell használniuk (TS 5).
⤢resolveJsonModule	Az importok .json fájlokat is betölthetnek típusos értékként.
⤢allowJs	A .js fájlok is a fordítás bemenetéhez tartoznak.
⤢checkJs	A .js fájlokat is típusellenőrzi, a JSDoc kommentjeiket olvasva; magában foglalja az allowJs-t.
⤢jsx	A .tsx fordításának módja: react-jsx (automatikus runtime), react (React.createElement) vagy preserve.
⤢types	Az automatikusan beolvasott @types csomagokat erre a listára korlátozza; az üres tömb egyet sem olvas be.
⤢typeRoots	Azok a mappák, amelyekben @types csomagokat keres, a fán felfelé található összes node_modules/@types helyett.
⤢isolatedModules	Biztosítja, hogy minden fájl önállóan transzpilálható legyen (a bundlerek és az esbuild megkövetelik).
Kimenet (emit)
⤢outDir	Hová kerül a lefordított JavaScript.
⤢rootDir	A forrásfájlok gyökere; stabilan tartja a kimeneti fa alakját.
⤢sourceMap	.js.map fájlokat állít elő, hogy a debuggerek visszatérképezzenek a TypeScriptre.
⤢inlineSourceMap	A source mapet kommentként ágyazza a .js fájlba .js.map fájl helyett.
⤢declaration	.d.ts típusdeklarációkat állít elő (könyvtárakhoz kell).
⤢declarationMap	.d.ts.map fájlokat állít elő, hogy a szerkesztők a deklarációktól a TypeScript-forráshoz ugorjanak.
⤢emitDeclarationOnly	Csak .d.ts fájlokat állít elő; a JavaScriptet bundlerre hagyja (declaration vagy composite szükséges hozzá).
⤢importHelpers	A __rest-szerű helpereket a tslibből újrahasznosítja, ahelyett hogy minden fájlba kiírná őket.
⤢downlevelIteration	Helyesen kezeli a for..of, spread és destrukturálást iterálhatókon, ha a target ES2015 előtti.
⤢removeComments	Eltávolítja a kommenteket a kibocsátott JavaScriptből.
⤢noEmit	Csak típusellenőriz, fájlt nem ír (akkor használatos, ha a bundler végzi az emitot).
Útvonalak
⤢baseUrl	Alapkönyvtár a nem relatív modulfeloldáshoz.
⤢paths	Import-előtagokat képez le helyekre, pl. { "@/*": ["src/*"] }.
⤢rootDirs	Több mappát egyetlen virtuális gyökérként kezel a feloldáshoz.
Projektszerkezet
⤢composite	Projektet buildelhetőként jelöl meg a projekt-referenciákhoz (bekapcsolja a declaration és incremental opciókat).
⤢references	Más tsconfig-projektekre támaszkodik a gyorsabb, izolált buildekhez.
⤢incremental	Elmenti a build-információt, hogy a következő futtatás kihagyhassa a változatlan fájlok újraellenőrzését.
Egyéb ellenőrzések
⤢skipLibCheck	Kihagyja a .d.ts fájlok típusellenőrzését a sebesség érdekében (alapból true).
⤢forceConsistentCasingInFileNames	Hibát jelez az olyan importokon, amelyek eltérnek a fájl tényleges kis- és nagybetűhasználatától.
⤢noUncheckedIndexedAccess	A tömb- és indexelési hozzáférés T | undefined-et ad vissza, nem T-t.
⤢useDefineForClassFields	Az osztályattribútumok Object.defineProperty-jel jönnek létre sima értékadás helyett (ES2022+ targeteknél alapból true).
⤢experimentalDecorators	Bekapcsolja a régebbi keretrendszerek által használt örökölt dekorátor-szintaxist (standard előtti).
⤢noErrorTruncation	A teljes típusneveket jelenti a hibaüzenetekben, a hosszúak csonkítása helyett.
⤢noUncheckedSideEffectImports	Hibát jelez, ha egy csupasz mellékhatás-import (import "./x.css") semmit sem old fel.
⤢allowImportingTsExtensions	Lehetővé teszi a .ts-re végződő importútvonalakat (noEmit vagy emitDeclarationOnly szükséges hozzá).