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"donnestring, 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
readonlyde 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 constajoute : 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 écrireas constà chaque appel.
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.