Resumo : neste tutorial, você aprenderá como usar o join()
método JavaScript Array para concatenar todos os elementos de um array em uma string separada por um separador.
Introdução ao método join() de array JavaScript
O join()
método permite concatenar todos os elementos de um array e retornar uma nova string :
Array.prototype.join([separator])
Linguagem de código: CSS ( css )
O join()
método aceita um argumento opcional separator
que é uma string que separa cada par de elementos adjacentes do array na string de resultado.
O separator
padrão é uma vírgula se você não passá-la para o join()
método.
Caso o array possua um elemento, o join()
método retorna esse elemento como uma string sem usar o separator
.
E se o array estiver vazio, o join()
método retornará uma string vazia.
Quando os elementos do array não são strings, o join()
método os converte em strings antes de unir.
Observe que o join()
método converte undefined
, null
e array vazio []
em uma string vazia.
Exemplos de métodos JavaScript Array join()
Vejamos alguns exemplos de uso do join()
método.
1) Usando o método JavaScript Array join() para ingressar em classes CSS
O exemplo a seguir usa o join()
método JavaScript Array para unir classes CSS:
const cssClasses = ['btn', 'btn-primary', 'btn-active'];
const btnClass = cssClasses.join(' ');
console.log(btnClass);
Linguagem de código: JavaScript ( javascript )
Saída:
btn btn-primary btn-active
Neste exemplo, temos um array que contém uma lista de classes CSS. E usamos o join()
método une todos os elementos do cssClasses
array e retornamos uma string das classes CSS separadas por um espaço.
2) Usando o método JavaScript Array join() para substituir todas as ocorrências de uma string
Este exemplo usa o join()
método JavaScript Array para substituir todas as ocorrências do espaço ' '
pelo hífen ( -
):
const title = 'JavaScript array join example';
const url = title.split(' ')
.join('-')
.toLowerCase();
console.log(url);
Linguagem de código: JavaScript ( javascript )
Saída:
javascript-array-join-example
Linguagem de código: PHP ( php )
Como funciona:
- Primeiro, divida a
title
string pelo espaço em um array usando osplit()
método string. - Segundo, concatene todos os elementos da matriz de resultados em uma string usando o
join()
método. - Terceiro, converta a string de resultado em minúsculas usando o
toLowerCase()
método.
Resumo
- Use o método JavaScript Array
join()
para concatenar todos os elementos de um array em uma string separada por um separador.