satisfies

Vérifie qu’une valeur correspond à un type sans modifier le type déduit.

Sur cette page

Exemple

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

#
Syntaxe
const value = expression satisfies Type

Plus d’exemples

#
Une annotation perd du détail
TypeScript
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 satisfies et as const : { … } as const satisfies Config.
  • Choisissez une annotation lorsque vous voulez que la variable ait un type général, et satisfies lorsque les types exacts des valeurs comptent pour vous.

Entrées associées

#

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