Formations — 1 037 leçons en français

Accueil › TypeScript › Fonctions d'assertion et never

Fonctions d'assertion et never

Gardes de type et assertionsavance

Un prédicat n'affine que dans un bloc. Une fonction d'assertion affine pour la suite du code, et lève si la condition est fausse.

function assertDefini<T>(v: T | undefined, nom: string): asserts v is T {
  if (v === undefined) throw new Error(`${nom} est absent`);
}

const cle = process.env.CLE_API;
//    ^? string | undefined
assertDefini(cle, "CLE_API");
cle.slice(0, 4);        // ✅ string, sans bloc englobant

asserts v is T se lit « si cette fonction revient, alors v est un T ». C'est la même promesse non vérifiée qu'un prédicat : le compilateur croit la signature. Une fonction d'assertion qui oublie son throw affine quand même.

La contrainte de la forme

L'analyse de flux doit connaître l'effet au point d'appel. Le compilateur exige donc un nom au type explicitement déclaré.

// ❌ TS2775 : « Assertions require every name in the call target
//    to be declared with an explicit type annotation. »
const assertChaine = (x: unknown): asserts x is string => { … };

// ✅ déclaration de fonction
function assertChaine(x: unknown): asserts x is string { … }

// ✅ ou annotation explicite du const
const assertChaine: (x: unknown) => asserts x is string = (x) => { … };

Une fonction fléchée est possible, mais seulement avec l'annotation sur la variable. Appeler l'assertion par une expression plutôt que par un nom donne TS2776.

Les termes à connaître

Fonction d'assertion

Une fonction dont le type de retour est asserts x is T ou asserts x. Si elle revient sans lever, le compilateur considère la condition acquise pour la suite du bloc.

`asserts cond`

La forme sans type : function invariant(c: unknown, m: string): asserts c. Elle affine ce que la condition impliquait, y compris un test de nullité.

`TS2775`

« Assertions require every name in the call target to be declared with an explicit type annotation. » Une fonction d'assertion ne peut pas être appelée via une variable sans annotation explicite.

`TS2776`

« Assertions require the call target to be an identifier or qualified name. » L'appel doit se faire par un nom, pas par une expression quelconque.

Retour `never`

Une fonction qui ne revient jamais. Le compilateur sait que le code qui la suit est inatteignable, et l'affinage en profite — mais seulement si le never est annoté.

`assertNever`

function assertNever(x: never): never { throw … }. Dans un default, elle prouve l'exhaustivité à la compilation et signale la variante inconnue à l'exécution.

`useUnknownInCatchVariables`

Inclus dans strict. La variable d'un catch est unknown et non any, parce que throw accepte n'importe quelle valeur en JavaScript.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.