`plugins` în TypeScript

tsconfig: editor și fișiere .d.ts TypeScript 2.3

Lista de pluginuri pentru serverul de limbaj din editor (completare, erori suplimentare); tsc le ignoră la compilare.

Sintaxă

"compilerOptions": {
  "plugins": [{ "name": "typescript-plugin-css-modules" }]
}

Ce face `plugins`

Pluginurile de limbaj adaugă funcții în editor: completare pentru clasele CSS, verificarea interogărilor SQL sau GraphQL scrise în șiruri, sugestii pentru un framework. Fiecare plugin este un pachet npm, iar în plugins scrii numele lui și eventual setări proprii.

Important: pluginurile rulează doar în editor (serverul de limbaj tsserver). tsc nu le încarcă, deci erorile raportate de un plugin nu opresc build-ul. În VS Code, pluginul trebuie instalat în proiect și editorul trebuie să folosească versiunea de TypeScript din node_modules. Implicit: nicio intrare.

Parametri

Parametru	Descriere
`[{ "name": "pachet", ... }]`	Pluginurile și setările lor.

Exemple

Exemplul 1: tsc ignoră pluginurile

Pachetul pluginului nici nu este instalat, dar tsc compilează fără nicio eroare. Opțiunea apare totuși în configurația finală.

// tsconfig.json
{
  "compilerOptions": {
    "module": "nodenext",
    "target": "es2022",
    "noEmit": true,
    "plugins": [{ "name": "typescript-plugin-css-modules" }]
  }
}

Rezultat (tsc 5.9)

$ npx tsc && echo "compilare fără erori"
compilare fără erori

$ npx tsc --showConfig | grep -A3 plugins
        "plugins": [
            {
                "name": "typescript-plugin-css-modules"
            }

Greșeli frecvente

Să te bazezi pe un plugin pentru verificări care trebuie să oprească build-ul. tsc nu îl rulează; folosește o unealtă separată în CI.

Comenzi înrudite

disableSizeLimit: Scoate limita de 20 MB de cod JavaScript pe care serverul de limbaj din editor o încarcă într-un proiect.
disableSourceOfProjectReferenceRedirect: Trei opțiuni pentru editor în proiectele cu references: cum se încarcă proiectele referite, ca editorul să fie mai rapid.

Ce face plugins