O método JavaScript Array join () retorna uma nova string concatenando todos os elementos em uma matriz, separados por um separador especificado.
A sintaxe do join()
método é:
arr.join(separator)
Aqui, arr é um array.
Parâmetros de join ()
O join()
método inclui:
- separator (opcional) - uma string para separar cada par de elementos adjacentes da matriz. Por padrão, é uma vírgula
,
.
Valor de retorno de join ()
- Retorna uma String com todos os elementos da matriz unidos por separador.
Notas :
- O
join()
método não altera a matriz original. - Elementos como
undefined
,null
ou array vazio têm uma representação de string vazia.
Exemplo: usando o método join ()
var info = ("Terence", 28, "Kathmandu"); var info_str = info.join(" | "); // join() does not change the original array console.log(info); // ( 'Terence', 28, 'Kathmandu' ) // join() returns the string by joining with separator console.log(info_str); // Terence | 28 | Kathmandu // empty argument = no separator var collection = (3, ".", 1, 4, 1, 5, 9, 2); console.log(collection.join("")); // 3.141592 var random = (44, "abc", undefined); console.log(random.join(" and ")); // 44 and abc and
Resultado
('Terence', 28, 'Kathmandu') Terence | 28 Kathmandu 3.141592 44 e abc e
Aqui, podemos ver que o join()
método converte todos os elementos do array em uma string e separa cada elemento pelo separador especificado.
Leituras recomendadas:
- Array JavaScript toString ()
- Divisão de string JavaScript ()