Il metodo join()
unisce tutti gli elementi di un array (o di un array di oggetti) in una stringa che viene restituita.
var a = ['Wind', 'Rain', 'Fire'];
a.join(); // 'Wind,Rain,Fire'
a.join('-'); // 'Wind-Rain-Fire'
Sintassi
arr.join() arr.join(separatore)
Parametri
separatore
Optional- Specifica una stringa che separa ogni coppia di elementi adiacenti dell'array. Il separatore è trasformato in una stringa, se necessario. Se omesso, gli elementi dell'array saranno separati da una virgola (","). Se il
separatore
è una stringa vuota, tutti gli elementi sono uniti senza alcun carattere intemedio.
Valore di risposta
Una stringa con tutti con tutti gli elementi dell'array uniti. Se arr.length
è 0
, viene restituita una stringa vuota.
Descrizione
Le stringe ottenute dalla conversione di tutti gli elementi dell'array sono unite in un unica stringa.
Se un elemento è undefined
o null
, sarà convertito in una stringa vuota.
Esempi
Quattro modi per concatenare un array
Il seguente esempio crea un array, a
, con tre elementi, quindi unisce gli elementi dell'array quattro volte: usando l'operatore di default, poi una virgola e uno spazio, poi un più e infine una stringa vuota.
var a = ['Wind', 'Rain', 'Fire'];
a.join(); // 'Wind,Rain,Fire'
a.join(', '); // 'Wind, Rain, Fire'
a.join(' + '); // 'Wind + Rain + Fire'
a.join(''); // 'WindRainFire'
Unione di un oggetto di tipo array
Il seguente esempio unisce un oggetto di tipo array (arguments
), chiamando Function.prototype.call
con Array.prototype.join
.
function f(a, b, c) {
var s = Array.prototype.join.call(arguments);
console.log(s); // '1,a,true'
}
f(1, 'a', true);
Specifiche
Specifiche | Stato | Commenti |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Definizione iniziale. Implementato in JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) The definition of 'Array.prototype.join' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Array.prototype.join' in that specification. |
Standard | |
ECMAScript (ECMA-262) The definition of 'Array.prototype.join' in that specification. |
Living Standard |
Compatibilità browser
BCD tables only load in the browser