`allowImportingTsExtensions` în TypeScript

tsconfig: module și rezolvarea importurilor TypeScript 5.0

Permite importuri cu extensia .ts ("./calcul.ts"), când codul este rulat direct de Node.js, Deno, Bun sau de un bundler.

Sintaxă

"compilerOptions": {
  "allowImportingTsExtensions": true,
  "noEmit": true
}

Ce face `allowImportingTsExtensions`

De obicei, în TypeScript scrii importul cu extensia fișierului generat: "./calcul.js". Uneltele care rulează direct fișiere .ts (Node.js 23.6+, Deno, Bun, Vite) au însă nevoie de numele real: "./calcul.ts". Cu allowImportingTsExtensions, tsc acceptă extensiile .ts, .mts, .cts și .tsx în importuri.

Opțiunea merge doar cu noEmit sau emitDeclarationOnly: tsc nu rescrie importurile, deci fișierele .js generate ar importa fișiere .ts (eroarea TS5096). tsc verifică doar tipurile, iar altă unealtă rulează codul. Dacă vrei și fișiere .js, folosește rewriteRelativeImportExtensions. Implicit: false.

Parametri

Parametru	Descriere
`true`	Importurile pot avea extensia `.ts`/`.mts`/`.cts`/`.tsx`. Necesită `noEmit` sau `emitDeclarationOnly`.
`false`	Valoarea implicită; importul cu `.ts` dă TS5097.

Exemple

Exemplul 1: Verificare cu tsc, rulare cu Node.js

tsc verifică tipurile (fără să scrie fișiere), iar Node.js rulează direct index.ts, eliminând tipurile la încărcare.

// package.json
{ "type": "module" }

// tsconfig.json
{
  "compilerOptions": {
    "module": "nodenext",
    "allowImportingTsExtensions": true,
    "noEmit": true
  }
}

// calcul.ts
export function cuTva(pret: number): number {
  return Math.round(pret * 1.19 * 100) / 100;
}

// index.ts
import { cuTva } from "./calcul.ts";

console.log(cuTva(100));

Rezultat (tsc 5.9)

$ npx tsc && node index.ts
119

Exemplul 2: Fără opțiune sau fără noEmit

Primul rezultat: același cod, cu noEmit, dar fără allowImportingTsExtensions. Al doilea: cu opțiunea, dar fără noEmit.

// tsconfig.json
{
  "compilerOptions": {
    "module": "nodenext",
    "allowImportingTsExtensions": true
  }
}