Formations — 1 037 leçons en français

Accueil › TypeScript › Les tuples

Les tuples

Tableaux, tuples et enumsdebutant

Un tuple est un tableau dont la longueur et le type de chaque position sont connus du compilateur.

let point: [number, number] = [3, 4];
let entree: [string, boolean] = ["actif", true];

point = [3, 4, 5];
// Erreur : Type '[number, number, number]' is not assignable to
// type '[number, number]'. Source has 3 element(s) but target allows only 2. ts(2322)

La différence avec number[] est que le tuple sait compter :

const t: [number, number] = [3, 4];
t[2];
// Erreur : Tuple type '[number, number]' of length '2'
// has no element at index '2'. ts(2493)

C'est le même tableau JavaScript à l'exécution. Seule la connaissance change.

Un tuple se justifie quand la position porte un sens que le code ne veut pas nommer :

const [valeur, setValeur] = useState(0);        // tuple de deux
for (const [cle, v] of Object.entries(obj)) {}  // tuple de deux

Dans les deux cas, l'appelant renomme librement à la déstructuration — c'est tout l'intérêt par rapport à un objet.

Au-delà de deux éléments, un objet est presque toujours préférable.

// ❌ qui se souvient de l'ordre ?
type Position = [number, number, number];

// ✓
type Position = { latitude: number; longitude: number; altitude: number };

Trois number dans un tuple, c'est trois façons de se tromper sans qu'aucune ne produise d'erreur de compilation. Un objet nomme, et accepte un champ supplémentaire sans casser les appels existants.

Les termes à connaître

Tuple

Un tableau dont la longueur et le type de chaque position sont connus : [number, number]. La position porte le sens, à la place d'un nom.

Étiquette de position

Le nom décoratif donné à un élément de tuple : [x: number, y: number]. Il n'existe qu'à la compilation, et sert l'aide à la frappe et les messages d'erreur.

Élément optionnel

Une position suivie de ? : [string, number?]. Le tuple accepte alors deux longueurs, et length devient 1 | 2.

Élément rest

Une position variadique : [string, ...number[]] décrit un premier élément imposé suivi d'un nombre quelconque de nombres. Un tuple n'en contient qu'un.

`length` littéral

Sur un tuple de longueur fixe, length n'est pas number mais le littéral exact — 2 pour [number, number]. C'est ce qui permet au compilateur de refuser l'index 2.

`TS2493`

« Tuple type '[A, B]' of length '2' has no element at index '2' » : l'erreur qui prouve qu'un tuple connaît sa longueur, contrairement à un tableau.

Tuple readonly

readonly [number, number], ce que produit un as const sur un littéral de tableau. Les positions sont figées et les méthodes de mutation absentes.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.