Formations — 1 037 leçons en français

Accueil › TypeScript › as const et les types littéraux

as const et les types littéraux

Tableaux, tuples et enumsdebutant

Par défaut, TypeScript élargit le type d'une valeur mutable : il remplace le littéral par son primitif.

let a = "ok";              // string
const b = "ok";            // "ok"
const c = { mode: "ok" };  // { mode: string }  ← la propriété est mutable
const d = ["a", "b"];      // string[]

Le cas c est celui qui surprend. const fige la liaison, pas le contenu : c.mode = "ko" est légal, donc le type ne peut pas être "ok".

function appliquer(m: "clair" | "sombre") {}
const config = { mode: "sombre" };
appliquer(config.mode);
// Erreur : Argument of type 'string' is not assignable to
// parameter of type '"clair" | "sombre"'. ts(2345)

as const demande l'inverse : conserver les littéraux, et rendre la valeur non modifiable, récursivement.

const config = { mode: "sombre" } as const;   // { readonly mode: "sombre" }
appliquer(config.mode);                       // accepté

const routes = ["/", "/profil"] as const;     // readonly ["/", "/profil"]

Un tableau devient un tuple readonly de littéraux. C'est la clé de la plupart des types dérivés :

type Route = (typeof routes)[number];   // "/" | "/profil"

Une seule source de vérité : le tableau. L'union en découle, et ajouter une entrée met le type à jour. C'est ce mécanisme qui rend l'enum inutile dans la quasi-totalité des cas.

as const n'écrit aucun code. Après compilation, il ne reste que l'objet ou le tableau — mutable comme n'importe quel autre.

Les termes à connaître

Élargissement (`widening`)

Le comportement par défaut : TypeScript remplace le type littéral d'une valeur mutable par son primitif. let s = "ok" donne string, pas "ok".

`as const`

Une assertion qui demande de conserver les types littéraux et de rendre la valeur readonly, récursivement. Elle ne change rien au code produit.

Type littéral

Un type dont le seul habitant est une valeur précise : "ok", 42, true. C'est la brique de toute union fermée.

`(typeof T)[number]`

La lecture d'un tableau par index typé : appliquée à un tuple readonly de littéraux, elle produit l'union de ses éléments. Le mécanisme central des types dérivés.

`satisfies`

Un opérateur (TypeScript 4.9) qui vérifie qu'une valeur respecte un type sans élargir son type inféré. Le complément naturel de as const.

`readonly` profond

Ce que as const ajoute : chaque propriété et chaque position de tableau devient non modifiable, à tous les niveaux. Uniquement à la compilation.

Paramètre de type `const`

function f<const T>(x: T) (TypeScript 5.0) : l'appelant obtient l'inférence littérale sans écrire as const à chaque appel.

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.