TypeScriptTypes de base

Tuples

Des tableaux de longueur fixe où chaque position a son propre type.

Sur cette page

Exemple

#
TypeScript
function minMax(values: number[]): [number, number] {
  return [Math.min(...values), Math.max(...values)]
}

const [lowest, highest] = minMax([72, 95, 64, 88])
console.log(lowest, highest)
Résultat
64 95

Définition et utilisation

#

Un tuple est un tableau avec un nombre déterminé d’éléments et un type connu à chaque position. La notation [string, number] signifie : le premier élément est une chaîne, le second un nombre, et rien d’autre.

Les tuples sont parfaits pour renvoyer plusieurs valeurs depuis une fonction, par exemple une paire de coordonnées, ou le résultat de useState en React, qui renvoie [valeur, fonction].

Vous pouvez nommer les positions pour plus de clarté ([name: string, points: number]) et marquer une position comme optionnelle avec un point d’interrogation. Les noms ne changent pas le comportement, mais ils apparaissent dans les suggestions de l’éditeur.

Syntaxe

#
Syntaxe
let pair: [string, number] = ["Emma", 120]

Plus d’exemples

#
Positions nommées et erreur de longueur
TypeScript
type Score = [name: string, points: number]

const lea: Score = ['Léa', 120]
const wrong: Score = ['Lucas', 90, true]
// Erreur : Source has 3 element(s) but target allows only 2.

Bonnes pratiques

#
  • Quand un tuple a plus de 2 ou 3 positions, il est préférable de renvoyer un objet avec des champs nommés.
  • La déstructuration const [a, b] = ... est la façon la plus pratique de lire un tuple.

Entrées associées

#

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