CKTIS / JavaScript
String.prototype.split — Text in ein Array aufteilen
String.prototype.split teilt Text anhand eines Trennzeichens und gibt ein Array der Teile zurück. Erfahre, wie das Limit und leere Elemente funktionieren und worin sich ein leeres von einem ausgelassenen Trennzeichen unterscheidet.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
string.split(separator, limit)String.prototype.split teilt Text von links nach rechts, ohne das Original zu verändern. Ein Trennzeichen in Form einer Zeichenkette wird wörtlich abgeglichen und nicht in das Ergebnis-Array aufgenommen. Benachbarte Trennzeichen sowie Trennzeichen am Anfang oder Ende können leere Elemente erzeugen.
Wird separator ausgelassen oder ist es undefined, gibt die Methode ein Array mit der gesamten Zeichenkette zurück, sofern das Limit nicht null ist. Gibt es keinen Treffer, bleibt ebenfalls die gesamte Zeichenkette erhalten. Das Trennzeichen "" teilt in UTF-16-Codeeinheiten, die nicht unbedingt vollständigen, für Nutzer wahrnehmbaren Zeichen entsprechen; "".split("") gibt [] zurück.
Das optionale limit begrenzt die Anzahl der Elemente, nicht die Anzahl der Teilungen: Der verbleibende Text wird verworfen. Standardmäßig beträgt der Wert 2 ** 32 - 1; ein angegebener Wert wird durch ToUint32 konvertiert. Ein limit von 0 ergibt [].
Das Trennzeichen kann auch ein Objekt mit einer [Symbol.split]-Methode sein, zum Beispiel ein RegExp. In diesem Fall übergibt split dieser Methode den Empfänger und das Limit und gibt ihr Ergebnis direkt zurück; eine benutzerdefinierte Methode kann die oben beschriebenen Regeln ändern. Ein Aufruf von String.prototype.split mit null oder undefined als Empfänger löst einen TypeError aus.
Beispiele
const text = "red,,blue,";
console.log(JSON.stringify(text.split(",")));
console.log(JSON.stringify(text.split(",", 2)));
console.log(JSON.stringify(text.split()));
console.log(JSON.stringify("".split("")));Ergebnis
["red","","blue",""] ["red",""] ["red,,blue,"] []
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.