satisfies
Vérifie qu’une valeur correspond à un type sans modifier le type déduit.
Exemple
#type Palette = Record<string, string | [number, number, number]>
const colors = {
accent: '#a78bfa',
success: [16, 185, 129]
} satisfies Palette
console.log(colors.accent.toUpperCase())
console.log(colors.success.join(', '))#A78BFA 16, 185, 129
Définition et utilisation
#L’opérateur satisfies vérifie qu’une expression est compatible avec le type indiqué, mais conserve le type exact déduit de la valeur elle-même. C’est ce qui le distingue d’une annotation (const x: T = ...), qui « élargit » le type à T.
Vous obtenez deux avantages à la fois : le compilateur signale une faute de frappe ou un champ manquant, et il retient aussi les littéraux et clés précis de l’objet, de sorte que les suggestions restent exactes par la suite.
On l’utilise surtout avec les objets de configuration et les tables de couleurs, de routes ou de traductions, lorsque vous voulez à la fois une vérification de forme et des types détaillés conservés.
Syntaxe
#const value = expression satisfies TypePlus d’exemples
#const annotated: Palette = { accent: '#a78bfa' }
annotated.accent.toUpperCase()
// Erreur : Property 'toUpperCase' does not exist on type 'string | [number, number, number]'.Bonnes pratiques
#- Avec les objets de configuration, combinez
satisfiesetas const:{ … } as const satisfies Config. - Choisissez une annotation lorsque vous voulez que la variable ait un type général, et
satisfieslorsque les types exacts des valeurs comptent pour vous.
Entrées associées
#- as vs satisfiesas dit au compilateur de faire confiance à votre type sans rien vérifier, tandis que satisfies vérifie la conformité au type et garde le type exact déduit de la valeur.
- as constFige les littéraux d’une expression : les types les plus étroits et des champs en lecture seule.
- Assertion de type (as)Indiquer au compilateur le type d’une valeur lorsque vous en savez plus que lui.
- Record<Keys, Type>Crée un type d’objet avec des clés données, où chaque valeur a le même type.
- Inférence de typeLe compilateur détermine automatiquement les types sans que vous écriviez d’annotations.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.