"skipLibCheck"

Ignore la vérification des erreurs dans les fichiers de déclarations .d.ts, ce qui accélère la compilation.

Sur cette page

Exemple

#
JSON
{
  "compilerOptions": {
    "strict": true,
    "skipLibCheck": true
  }
}

Définition et utilisation

#

L’option skipLibCheck désactive la recherche d’erreurs à l’intérieur de tous les fichiers de déclarations .d.ts : ceux de node_modules et les vôtres. Le compilateur continue d’y lire les types et de vérifier votre code d’après eux, mais il ne contrôle pas les déclarations elles-mêmes.

Les principales raisons de l’activer sont une compilation plus rapide et l’évitement d’erreurs sur lesquelles vous n’avez aucune prise, par exemple deux paquets @types déclarant la même variable globale, ou des types de bibliothèque écrits pour une autre version de TypeScript.

Le prix à payer est un contrôle moindre : une faute de frappe dans votre propre fichier .d.ts passera inaperçue, et un type que le compilateur ne reconnaît pas se comportera comme any. Malgré cela, skipLibCheck: true est un réglage très répandu, présent notamment dans le fichier créé par tsc --init.

Syntaxe

#
Syntaxe
"skipLibCheck": true

Plus d’exemples

#
Une erreur dans votre propre déclaration
TypeScript
// src/types/legacy.d.ts
declare function formatPrice(value: number): Strin
// Sans skipLibCheck : Cannot find name 'Strin'. Did you mean 'String'?
// Avec skipLibCheck : aucune erreur

// src/app.ts
const label = formatPrice(49)
label.toFixedd(2)
// pas d’erreur non plus, car le type inconnu Strin se comporte comme any

Bonnes pratiques

#
  • Dans les applications, laissez skipLibCheck activée. Si vous écrivez vos propres fichiers .d.ts, vérifiez-les de temps en temps en compilant sans cette option, par exemple en CI.
  • Lorsque des erreurs apparaissent dans des fichiers de node_modules après une mise à jour de paquets, skipLibCheck les masquera. Il vaut toutefois la peine de vérifier que le projet ne contient pas deux versions différentes du même paquet @types.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.