Die join()
Methode kombiniert alle Elemente von einem Array zu einem String.
Syntax
str = arr.join([separator = ','])
Parameter
separator
- Optional. Spezifiziert einen String mit einen Trennzeichen, welches die Element eines Array trennt. Das Trennzeichen wird zu einem String umgewandelt wenn nötig. Wird kein Trennzeichen verwendet, wird der String mit einem Komma als Trennzeichen benutzt.
Return value
Ein String mit allen verbundenen Arrayelementen.
Beschreibung
Die Stringumwandlung von allen Elementen aus dem Array in einen String wird durchgeführt. Wenn ein Element undefined
oder null
ist, wird dieses in einen leeren String konvertiert.
Beispiele
Einen Array auf 4 verschiedene Arten mit join
umwandeln
Das folgende Beispiel erzeugt einen Array (a) mit 3 Elementen und fügt diese dann jeweils mit unterschiedlichen Trennzeichen zu einem String zusammen: mit dem Standardtrennzeichen, mit Komma und Leerzeichen, mit Pluszeichen mit Leerzeichen davor und danach und einem leeren String.
var a = ['Wind', 'Rain', 'Fire']; var myVar1 = a.join(); // assigns 'Wind,Rain,Fire' to myVar1 var myVar2 = a.join(', '); // assigns 'Wind, Rain, Fire' to myVar2 var myVar3 = a.join(' + '); // assigns 'Wind + Rain + Fire' to myVar3 var myVar4 = a.join(''); // assigns 'WindRainFire' to myVar4
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Erste 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 2017 Draft (ECMA-262) Die Definition von 'Array.prototype.join' in dieser Spezifikation. |
Entwurf |
Browserkompatibilität
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 1.0 | 1.0 (1.7 oder früher) | 5.5 | (Ja) | (Ja) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |