Intersection (A & B)

Un type qui combine en même temps tous les champs de plusieurs types.

Sur cette page

Exemple

#
TypeScript
type Timestamps = { createdAt: string; updatedAt: string }
type Lesson = { title: string; minutes: number }
type StoredLesson = Lesson & Timestamps

const lesson: StoredLesson = {
  title: 'Flexbox',
  minutes: 14,
  createdAt: '2026-09-01',
  updatedAt: '2026-09-28'
}

console.log(Object.keys(lesson).length)
Résultat
4

Définition et utilisation

#

Une intersection relie des types avec le signe &. Une valeur de type A & B doit satisfaire les deux types à la fois, c’est-à-dire avoir tous les champs de A et tous les champs de B.

On l’utilise le plus souvent pour composer des types d’objets à partir de petits morceaux, par exemple User & Timestamps, ou pour ajouter des champs à un type issu d’une bibliothèque. C’est l’équivalent de extends pour les alias type.

L’intersection de types mutuellement exclusifs (par exemple string & number) donne never. Il en va de même pour les champs de même nom mais de types incompatibles.

Syntaxe

#
Syntaxe
type Name = TypeA & TypeB

Bonnes pratiques

#
  • L’intersection est pratique pour composer des types d’objets, mais un conflit de noms de champs peut facilement produire never. Vérifiez le résultat dans votre éditeur.
  • Avec les interfaces, vous obtenez le même effet grâce à extends, qui signale les conflits plus clairement.

Entrées associées

#

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