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, etlengthdevient1 | 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,
lengthn'est pasnumbermais le littéral exact —2pour[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 unas constsur un littéral de tableau. Les positions sont figées et les méthodes de mutation absentes.
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.