Die join() Methode kombiniert alle Elemente von einem Arrays (oder Array-Ähnlichen Objektes) zu einem String und gibt diesen zurück.

Syntax

arr.join([separator])

Parameter

separator Optional
Spezifiziert einen String, der jedes Elemente-Paar aus dem Array trennt. Wenn es nötig ist, wird separator zu einem String konvertiert. Wird der parameter weggelassen, wird ein Komma (',') benutzt. Wenn separator der leere String ist, werden alle Elemente ohne Trennzeichen hintereinander geschrieben.

Rückgabewert

Ein String mit allen Arrayelementen. Wenn arr.length 0 ist, wird der leere String zurückgegeben.

Beschreibung

Die Stringumwandlung von allen Elementen aus dem Array in einen String wird durchgeführt.

Wenn ein Element undefined oder null ist, wird es in einen leeren String konvertiert.

Beispiele

Einen Array auf vier verschiedene Arten mit zusammenführen

Das folgende Beispiel erzeugt einen Array ,a, mit drei Elementen und fügt diese vier mal zu einem String zusammen: mit dem Standardtrennzeichen, mit Komma und Leerzeichen, mit Pluszeichen und einem leeren String.

var a = ['Wind', 'Rain', 'Fire'];
a.join();       // 'Wind,Rain,Fire'
a.join(', ');   // 'Wind, Rain, Fire'
a.join(' + ');  // 'Wind + Rain + Fire'
a.join('');     // 'WindRainFire'

Zusammenführen eines Array-Ähnlichen Objektes

Das Folgende Beispiel führt ein Array-Ähnliches Objekte (arguments) zusammen, indem Function.prototype.call auf Array.prototype.join aufgerufen wird.

function f(a, b, c) {
  var s = Array.prototype.join.call(arguments);
  console.log(s); // '1,a,true'
}
f(1, 'a', true);
// Erwartete Ausgabe: "1,a,true"

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 1st Edition (ECMA-262) Standard Initiale Definition. Implementiert in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Array.prototype.join' in dieser Spezifikation.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Array.prototype.join' in dieser Spezifikation.
Standard  
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Array.prototype.join' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Grundlegende Unterstützung1 Ja15.5 Ja Ja
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Grundlegende Unterstützung Ja Ja Ja4 Ja Ja Ja

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

 Mitwirkende an dieser Seite: schlagi123, wattafot, Saschlong, mieth
 Zuletzt aktualisiert von: schlagi123,