Abaixo, uma tabela de métodos que podem ser utilizados sobre o tipo de dado Tuple. O básico sobre Tuple foi visto em Tuple.

Com o método concat podemos concatenar um ou mais Tuples. Esse método recebe argumentos e retorna uma Tuple contendo os argumentos concatenados.

Sintaxe

variavel_tuple.concat( tuple1, tuple2, tupleN );

Onde

tuple1...N: Tuplas para concatenação.

Retorno

-

Exemplo 2

let tupla1: [number,string] = [1,'Fulano'];
let tupla2: [number,string] = [2,'Ciclano'];

let tupla3 = tupla1.concat(tupla2);

console.log(tupla3)

Saída

[ 'uma', 'string', 'qualquer' ]

Com o método entries podemos recuperar um iterador contendo índice/valor que representam os elementos de uma Tuple para iteração.

Sintaxe

variavel_tuple.entries()

Onde

-

Retorno

Iterador para elementos de variavel_tuple. 

Exemplo 4

let tupla: [number,string,boolean] = [1,'Fulano',true];

for ( let [ch,val] of tupla.entries())
    console.log(ch,val)

Saída

0,  1 
1,  "Fulano" 
2,  true 

O método every permite que passemos uma função como argumento. Essa função contém código que será executado para todos os elementos de uma Tuple. Essa função deve retornar true ou false.

Sintaxe

variavel_tuple.every( callback( currentValue, index, tuple ), thisArg);

Onde

callback: função que será invocada para cada elemento
currentValue: Parâmetro obrigatório que representa o elemento atual 
index: Índice do elemento atual. Opcional
tuple: o tuple do elemento atual, se houver. Opcional
thisArg: Valor passado passado como this.

Retorno

true se callback retorna true para todos elementos, false caso contrário.

Exemplo 5

let tupla: [number,number,number,number] = [0,2,4,6];

function teste(valor:any,indice:number,tupla:any): boolean {
  return valor %2 == 0;
}

console.log(tupla.every(teste));

Saída

true

Utilizando o método fill podemos preencher elementos de uma Tuple com um determinado valor fixo que é passado como argumento.

Sintaxe

variavel_tuple.fill(value, start, end);

Onde

value: valor para preenchimento.
start: índice inicial para preenchimento. O valor padrão é variavel.length. Esse argumento é opcional.
end: índice final para preenchimento que não é incluído no intervalo. O valor padrão é variavel.length. Esse argumento é opcional. 

Retorno

-

Exemplo 6

let tupla: [number,number,number,number] = [0,2,4,6];

console.log(tupla);
tupla.fill(-1,0)
console.log(tupla);

Saída

[0, 2, 4, 6] 
[-1, -1, -1, -1] 

O método filter permite criar uma nova Tuple baseada apenas nos elementos que são testados por uma função que é passada como argumentos e é chamada para cada elemento. Essa função deve retornar true ou false.

Sintaxe

variavel_tuple.filter(callback(currentValue, index, tuple), thisArg);

Onde

callback: função que será invocada para cada elemento
currentValue: Parâmetro obrigatório que representa o elemento atual 
index: Índice do elemento atual. Opcional
tuple: o tuple do elemento atual, se houver. Opcional
thisArg: Valor passado passado como this.

Retorno

 Nova Tuple contendo os elementos que retornaram true para a execução da callback.

Exemplo 7

let tupla: [number,number,number,number] = [1,2,4,6];

function teste(valor:any,indice:number,tupla:any): boolean {
  return valor %2 == 0;
}
console.log(tupla);
let filtro = tupla.filter(teste);
console.log(filtro);

Saída

[1, 2, 4, 6] 
[2, 4, 6] 

O método find permite encontrarmos o primeiro elemento de uma Tuple baseado em um teste feito por uma função que é passada como argumento e é executada para cada elemento. Essa função deve retornar true ou false.

Sintaxe

variavel_tuple.find(callback(currentValue, index, tuple), thisArg);

Onde

callback: função que será invocada para cada elemento
currentValue: Parâmetro obrigatório que representa o elemento atual 
index: Índice do elemento atual. Opcional
tuple: o array do elemento atual, se houver. Opcional
thisArg: Valor passado passado como this.

Retorno

Primeiro elemento que atende ao teste feito por callback ou undefined caso nenhum elemento atenda.

Exemplo 8

let  x:number[] = [1,2,3,4];

function teste(valor,indice,array){
  if (valor %2 == 0)
    return true;
  return false;
}
console.log(x.find(teste));

Saída

1

O método findIndex permite encontrarmos o índice do primeiro elemento de uma Tuple baseado em um teste feito por uma função que é passada como argumento e é chamada para cada elemento. Essa função deve retornar true ou false.

Sintaxe

variavel_tuple.findIndex(callback(currentValue, index, tuple), thisArg);

Onde

callback: função que será invocada para cada elemento
currentValue: Parâmetro obrigatório que representa o elemento atual 
index: Índice do elemento atual. Opcional
tuple: o tuple do elemento atual, se houver. Opcional
thisArg: Valor passado passado como this.

Retorno

Valor inteiro contendo o índice do primeiro elemento que atende ao teste feito por callback
undefined caso nenhum elemento atenda ao teste.

Exemplo 9

let tupla: [number,number,number,number] = [1,2,4,6];

function teste(valor:any,indice:number,tupla:any): boolean {
  return valor %2 != 0;
}
console.log(tupla.findIndex(teste));

Saída

1

O método forEach permite criar uma nova Tuple baseado apenas nos elementos que são testados por uma função que é passada como argumentos e é chamada para cada elemento. Essa função deve retornar true ou false.

Sintaxe

variavel_tuple.forEach(callback(currentValue, index, tuple), thisArg);

Onde

callback: função que será invocada para cada elemento
currentValue: Parâmetro obrigatório que representa o elemento atual 
index: Índice do elemento atual. Opcional
tuple: o tuple do elemento atual se houver. Opcional
thisArg: Valor passado passado como this.

Retorno

Nova tuple contendo os elementos que retornaram true para a execução da callback.

Exemplo 10

let tupla: [number,number,number,number] = [0,2,4,6];

function teste(valor:any,indice:number,tupla:any): boolean {
  console.log(indice,valor);
  return true;
}
tupla.forEach(teste);

Saída

[ 2, 4 ]

O método includes verifica se um determinado elemento, que é passado como argumentos, está contido ou não em uma Tuple.

Sintaxe

variavel_tuple.includes( element, fromIndex);

Onde

element: elemento para verificar existência.
fromIndex: índice inicial para busca. Opcional

Retorno

 true se element for encontrado, false caso contrário.

Exemplo 11

let tupla: [number,string,boolean] = [1, 'Fulano',true];

console.log(tupla.includes('Fulano'));

Saída

true

Utilizando o método indexOf podemos descobrir qual o índice de um determinado elemento passado por argumento.

Sintaxe

variavel_tupla.indexOf(element, fromIndex);

Onde

element: elemento para verificar existência.
fromIndex: índice inicial para busca.

Retorno

Inteiro contendo o índice de element, NaN caso contrário.

Exemplo 14

let tupla: [number,string,boolean] = [1, 'Fulano',true];

console.log(tupla.indexOf('Fulano'));

Saída

1

O método join faz a união e conversão de todos elementos de uma Tuple em uma única string que é retornada por esse método.

Sintaxe

variavel_tuple.join(separator);

Onde

separator: separador utilizado entre os elementos unidos pelo join. Opcional

Retorno

String contendo os elementos de variavel_tuple separados por separator

Exemplo 15

let tupla: [number,string,boolean] = [1, 'Fulano',true];

console.log(tupla.join());

Saída

"1,Fulano,true" 

O método keys é utilizado para recuperar um iterador contendo todos os índices de uma Tuple.

Sintaxe

variavel_tuple.keys()

Onde

-

Retorno

Iterador para as chaves dos elementos de uma Tuple. 

Exemplo 17

let tupla: [number,string,boolean] = [1, 'Fulano',true];

for ( let i of tupla.keys())
    console.log(i);

Saída

0 
1 
2 

Utilizando o método lastIndexOf podemos descobrir qual o índice da última ocorrência de um determinado elemento passado por argumento.

Sintaxe

variavel_tuple.lastIndexOf(element, fromIndex);

Onde

element: elemento para verificar existência.
fromIndex: índice inicial para busca.

Retorno

 Inteiro contendo o índice de element, -1 caso contrário.

Exemplo 18

let tupla: [number,string,boolean] = [1, 'Fulano',true];

console.log(tupla.lastIndexOf('Fulano'));

Saída

1

1. 29/08/2025 - revisão 2 - Ajustes: pontuais e sintaxes
2. 14/09/2024 - revisão 1 - Ajsutes gramaticais
3. 29/02/2024 - versão inicial