as const
Fige les littéraux d’une expression : les types les plus étroits et des champs en lecture seule.
Exemple
#const LEVELS = ['easy', 'medium', 'hard'] as const
type Level = (typeof LEVELS)[number]
// type Level = "easy" | "medium" | "hard"
function isLevel(value: string): value is Level {
return (LEVELS as readonly string[]).includes(value)
}
console.log(LEVELS.length)
console.log(isLevel('hard'), isLevel('expert'))3 true false
Définition et utilisation
#L’assertion as const fait déduire à TypeScript les types les plus étroits possible : les chaînes deviennent des littéraux ("dark" au lieu de string), les tableaux deviennent des tuples en lecture seule et les champs d’objet deviennent readonly.
Cela permet de dériver une union de valeurs autorisées à partir d’une seule constante : const LEVELS = ["easy", "hard"] as const et type Level = typeof LEVELS[number] donnent "easy" | "hard".
C’est une alternative populaire aux enums. Les valeurs existent en JavaScript sous forme de simple tableau ou objet, et les types en sont générés automatiquement.
Syntaxe
#const constant = expression as constPlus d’exemples
#const Status = {
Draft: 'draft',
Published: 'published'
} as const
type Status = (typeof Status)[keyof typeof Status]
// type Status = "draft" | "published"
const current: Status = Status.Published
console.log(current)published
Bonnes pratiques
#- Le motif
const X = [...] as constavectype T = typeof X[number]vous donne à la fois une liste de valeurs à parcourir et un type union. - Un objet avec
as constest une alternative plus légère à un enum, et il ne génère aucun code supplémentaire.
Entrées associées
#- Types littérauxDes types qui n’autorisent que des valeurs précises, par ex. "easy" | "hard".
- enumUn ensemble nommé de valeurs constantes, numériques ou textuelles.
- typeof (dans les types)Récupère le type d’une variable ou d’une valeur pour l’utiliser ailleurs.
- readonlyUn modificateur qui bloque la modification d’un champ après la création de l’objet.
- satisfiesVérifie qu’une valeur correspond à un type sans modifier le type déduit.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.