TypeScript · Essencial · Português · Técnico
tupla
Array de tamanho fixo em que cada posição tem seu próprio tipo, como [string, number]. Permite devolver vários valores tipados em uma só estrutura.
Onde usar
Aparece em retornos como [estado, setEstado] e em pares chave-valor. A tupla evita criar um objeto quando a posição basta, mas, a partir de três ou quatro campos, um objeto com nomes é mais legível.
Em código
const par: [string, number] = ['idade', 30];
const [chave, valor] = par;
type Faixa = [number, number];
function minmax(xs: number[]): Faixa {
return [Math.min(...xs), Math.max(...xs)];
}
const [lo, hi] = minmax([3, 1, 9]);Exemplos
Essa função retorna uma tupla com o valor e o erro.
Usei uma tupla porque são só dois campos e a ordem é fixa.
Cuidado
Não confunda com um array comum: string[] aceita qualquer quantidade de itens, enquanto [string, string] exige exatamente dois.
Sinônimos
tuple
Origem
Do inglês tuple, extraído de palavras como quintuple e sextuple; na matemática, é uma sequência ordenada de n elementos.