--- title: Array.prototype.join() slug: Web/JavaScript/Reference/Global_Objects/Array/join tags: - Array - JavaScript - Prototype - Referenza - metodo translation_of: Web/JavaScript/Reference/Global_Objects/Array/join ---
{{JSRef}}

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_inline}}
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 {{jsxref("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
{{SpecName('ES1')}} {{Spec2('ES1')}} Definizione iniziale. Implementato in JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.4.4.5', 'Array.prototype.join')}} {{Spec2('ES5.1')}}  
{{SpecName('ES6', '#sec-array.prototype.join', 'Array.prototype.join')}} {{Spec2('ES6')}}  
{{SpecName('ESDraft', '#sec-array.prototype.join', 'Array.prototype.join')}} {{Spec2('ESDraft')}}  

Compatibilità browser

{{Compat("javascript.builtins.Array.join")}}

Guarda anche