as const

Fige les littéraux d’une expression : les types les plus étroits et des champs en lecture seule.

Sur cette page

Exemple

#
TypeScript
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'))
Résultat
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

#
Syntaxe
const constant = expression as const

Plus d’exemples

#
Un objet en remplacement d’un enum
TypeScript
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)
Résultat
published

Bonnes pratiques

#
  • Le motif const X = [...] as const avec type T = typeof X[number] vous donne à la fois une liste de valeurs à parcourir et un type union.
  • Un objet avec as const est une alternative plus légère à un enum, et il ne génère aucun code supplémentaire.

Entrées associées

#

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