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

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidEdge MobileFirefox für AndroidOpera für AndroidiOS SafariSamsung InternetNode.js
Grundlegende UnterstützungChrome Vollständige Unterstützung 1Edge Vollständige Unterstützung JaFirefox Vollständige Unterstützung 1IE Vollständige Unterstützung 5.5Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung JaWebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaEdge Mobile Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja

Legende

Vollständige Unterstützung  
Vollständige Unterstützung

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

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