Um array (ou lista) guarda uma sequência ordenada de valores entre colchetes [ ]. Ele pode guardar números, textos, objetos ou até outros arrays.
A maioria dos métodos modernos como map(), filter() e slice() devolve um array novo sem alterar o original. Métodos clássicos como push(), pop(), sort() e reverse() alteram a lista no próprio lugar.
Descubra quantos itens existem na lista e pegue itens em posições específicas.
lengthInforma quantos itens o array possui. É uma propriedade, portanto vai sem parênteses. Também permite esvaziar o array definindo lista.length = 0.
lista.lengthconst frutas = ['maçã', 'banana', 'laranja'];
console.log(frutas.length);
console.log([].length);3 0
at()Pega o elemento em uma posição. Aceita índices negativos para contar a partir do final (-1 é o último item).
lista.at(posicao)undefined se a posição não existir.const letras = ['a', 'b', 'c', 'd'];
console.log(letras.at(0));
console.log(letras.at(-1));
console.log(letras[1]);a d b
Operações rápidas no início e no fim da lista. Todas modificam o array original.
push()Adiciona um ou mais itens ao final do array. Modifica o array original e devolve o novo tamanho.
lista.push(item1, item2)length) do array.const fila = ['Ana', 'Bruno'];
const tamanho = fila.push('Carla');
console.log(fila);
console.log(tamanho);[ 'Ana', 'Bruno', 'Carla' ] 3
pop()Remove o último elemento do array e o devolve. Modifica o array original.
lista.pop()undefined se o array estiver vazio.const pilha = [10, 20, 30];
const tirado = pilha.pop();
console.log(pilha);
console.log(tirado);[ 10, 20 ] 30
unshift()Adiciona um ou mais itens no início do array e empurra os outros para frente. Devolve o novo tamanho.
lista.unshift(item1, item2)length) do array.const podium = ['Prata', 'Bronze'];
podium.unshift('Ouro');
console.log(podium);[ 'Ouro', 'Prata', 'Bronze' ]
shift()Remove o primeiro elemento do array e o devolve. Modifica o array original.
lista.shift()undefined se o array estiver vazio.const clientes = ['Lucas', 'Marina', 'Pedro'];
const atendido = clientes.shift();
console.log(atendido);
console.log(clientes);Lucas [ 'Marina', 'Pedro' ]
Os métodos funcionais mais poderosos: não modificam o array original e devolvem uma nova lista.
map()Aplica uma função em cada item e cria um novo array com os resultados transformados.
lista.map((item, indice) => novoItem)const numeros = [1, 2, 3, 4];
const dobrados = numeros.map((n) => n * 2);
console.log(dobrados);
console.log(numeros);[ 2, 4, 6, 8 ] [ 1, 2, 3, 4 ]
filter()Cria um novo array com apenas os itens que passaram no teste (onde a função devolveu true).
lista.filter((item, indice) => condicao)const idades = [12, 18, 25, 15, 30];
const maiores = idades.filter((i) => i >= 18);
console.log(maiores);[ 18, 25, 30 ]
reduce()Reduz a lista inteira a um único valor (uma soma, uma média ou um objeto agrupado) acumulando os resultados.
lista.reduce((acumulador, item) => novoAcumulador, valorInicial)const valores = [10, 20, 30];
const soma = valores.reduce((total, valor) => total + valor, 0);
console.log(soma);60
flat()Achata sub-arrays aninhados em um único array plano. Por padrão achata 1 nível.
lista.flat(profundidade)const caixas = [[1, 2], [3, 4], [5]];
console.log(caixas.flat());
console.log([1, [2, [3]]].flat(2));[ 1, 2, 3, 4, 5 ] [ 1, 2, 3 ]
flatMap()Combina um map() com um flat(1). Ideal quando cada item gera uma lista interna de elementos.
lista.flatMap((item) => subLista)const frases = ['bom dia', 'boa tarde'];
const palavras = frases.flatMap((f) => f.split(' '));
console.log(palavras);[ 'bom', 'dia', 'boa', 'tarde' ]
Encontre elementos ou teste se os dados atendem a critérios.
find()Devolve o primeiro elemento que satisfaz a condição da função. Se ninguém atender, devolve undefined.
lista.find((item) => condicao)undefined.const usuarios = [{ id: 1, nome: 'Ana' }, { id: 2, nome: 'Beto' }];
const achado = usuarios.find((u) => u.id === 2);
console.log(achado);{ id: 2, nome: 'Beto' }findIndex()Devolve o índice do primeiro elemento que satisfaz a condição. Se ninguém atender, devolve -1.
lista.findIndex((item) => condicao)-1.const notas = [6, 4, 8, 3];
const indice = notas.findIndex((n) => n < 5);
console.log(indice);1
includes()Diz se um determinado valor está presente no array. Faz comparação estrita (===).
lista.includes(valorProcurado)true se o valor estiver na lista, senão false.const convidados = ['Lucas', 'Carla', 'Tiago'];
console.log(convidados.includes('Carla'));
console.log(convidados.includes('Marcos'));true false
some()Testa se pelo menos um elemento satisfaz a condição. Devolve true assim que encontra um caso favorável.
lista.some((item) => condicao)true se houver pelo menos um correspondente, senão false.const notas = [5, 4, 8, 3];
const temAprovado = notas.some((n) => n >= 6);
console.log(temAprovado);true
every()Testa se todos os elementos satisfazem a condição. Devolve false assim que encontra a primeira falha.
lista.every((item) => condicao)true se todos passarem no teste, senão false.const idades = [20, 25, 19, 30];
console.log(idades.every((i) => i >= 18));
console.log([18, 15, 22].every((i) => i >= 18));true false
indexOf() e lastIndexOf()indexOf() devolve a primeira posição onde um item simples aparece; lastIndexOf(), a última.
lista.indexOf(valor)
lista.lastIndexOf(valor)-1 se o elemento não for encontrado.const cores = ['azul', 'vermelho', 'verde', 'vermelho'];
console.log(cores.indexOf('vermelho'));
console.log(cores.lastIndexOf('vermelho'));
console.log(cores.indexOf('preto'));1 3 -1
Crie fatias ou junte itens em novas listas ou em strings.
slice()Copia uma fatia do array do inicio até antes do fim. Não altera o array original e aceita índices negativos.
lista.slice(inicio, fim)const letras = ['a', 'b', 'c', 'd', 'e'];
console.log(letras.slice(1, 4));
console.log(letras.slice(-2));[ 'b', 'c', 'd' ] [ 'd', 'e' ]
concat()Junta dois ou mais arrays em um novo array, sem modificar os originais.
lista.concat(outraLista, maisUma)const pares = [2, 4];
const impares = [1, 3];
const todos = pares.concat(impares);
console.log(todos);[ 2, 4, 1, 3 ]
join()Transforma o array em uma string, juntando todos os elementos com o separador escolhido.
lista.join(separador)const palavras = ['Aprender', 'JavaScript', 'é', 'legal'];
console.log(palavras.join(' '));
console.log([1, 2, 3].join('-'));Aprender JavaScript é legal 1-2-3
Altere a ordem dos elementos numéricos e textuais.
sort() e toSorted()Ordena os elementos. sort() altera o array original no lugar; toSorted() devolve um novo array ordenado sem alterar o original.
lista.sort((a, b) => a - b)
lista.toSorted((a, b) => a - b)const numeros = [10, 5, 40, 25];
numeros.sort((a, b) => a - b);
console.log(numeros);[ 5, 10, 25, 40 ]
reverse() e toReversed()Inverte a ordem dos itens. reverse() modifica o array original; toReversed() devolve um novo array invertido.
lista.reverse()
lista.toReversed()const ordem = [1, 2, 3, 4];
ordem.reverse();
console.log(ordem);[ 4, 3, 2, 1 ]
Quer testar? Copie um exemplo e rode no Rascunho.