[T, U] Tipo tuple
Última atualização: 2026-10-22
[T, U] Tipo tuple
Uma tupla é um tipo de array de comprimento fixo com tipos por posição — ideal para coordenadas, pares chave-valor e retornos múltiplos, onde a posição carrega significado.
| Grupo | Tipos Básicos |
|---|---|
| Tipo | Tipo |
| Modo strict | Não necessário |
ℹ️ Info O editor transpila TypeScript para JavaScript e o executa (sem verificação de tipos); veja a Saída de cada exemplo para o resultado da verificação.
📝 Sintaxe
type Point = [number, number];
type Named = [name: string, age: number]; // tupla rotulada
let pair: Point = [3, 4];⚙️ Parâmetros
| [T, U] | Tipos por posição: o índice 0 é T, o índice 1 é U; o comprimento também é fixo |
|---|---|
| [lat: number] | [lat: number, lng: number] dá nome a cada posição, puramente para legibilidade |
Retorno：Nenhum valor de retorno — tuplas existem apenas na camada de tipos; em tempo de execução é um array comum.
▶ Exemplo
Edite o código abaixo e clique em Testar para ver o resultado transpilado:
Saída：
rgb(255, 0, 0)
(Saída de execução após a transpilação; red.push("x") e red = [255, 0] são ambos erros de compilação)💡 Observações
ℹ️ Info Uma tupla é um array comum em tempo de execução; a restrição de comprimento existe apenas em tempo de compilação.
💡 Dica Tuplas nomeadas como [lat: number, lng: number] melhoram o destructuring e as dicas do IDE — fortemente recomendadas para múltiplos valores de retorno.
⚠️ Atenção push ainda pode anexar elementos do tipo declarado além do comprimento fixo: [number, number].push(1) é permitido. A semântica de posição depende de disciplina.
🏷️ Tipos Básicos Relacionados
💡 Casos relacionados
Mais casos em breve.
📚 Tutoriais relacionados
❓ Perguntas frequentes
P Qual é a diferença entre tuplas e arrays?
R Arrays variam em comprimento com um tipo de elemento; tuplas são fixas com tipos por posição. Use tuplas quando "cada slot significa algo diferente", como [lng, lat], e arrays para coleções.
P Elementos de tupla podem ser opcionais?
R Sim — [string, number?] significa que o segundo slot pode estar ausente; elementos opcionais devem vir por último.
P Como tuplas se relacionam com rest parameters?
R Rest parameters são tuplas: function f(...args: [string, number]) exige precisamente uma string e depois um number.
