String.prototype.split()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die split() Methode von String Werten nimmt ein Muster und teilt diesen String in eine geordnete Liste von Unterstrings, indem sie nach dem Muster sucht, legt diese Unterstrings in ein Array und gibt das Array zurück.

Probieren Sie es aus

const str = "The quick brown fox jumps over the lazy dog.";

const words = str.split(" ");
console.log(words[3]);
// Expected output: "fox"

const chars = str.split("");
console.log(chars[8]);
// Expected output: "k"

const strCopy = str.split();
console.log(strCopy);
// Expected output: Array ["The quick brown fox jumps over the lazy dog."]

Syntax

js
split(separator)
split(separator, limit)

Parameter

separator

Das Muster, das beschreibt, wo jeder Split erfolgen soll. Kann undefined, ein String oder ein Objekt mit einer Symbol.split Methode sein — typischerweise ein Regulärer Ausdruck. Das Auslassen von separator oder das Übergeben von undefined führt dazu, dass split() ein Array mit dem aufrufenden String als einziges Element zurückgibt. Alle Werte, die nicht undefined oder Objekte mit einer [Symbol.split]() Methode sind, werden zu Strings gezwungen.

limit Optional

Eine nicht-negative ganze Zahl, die eine Begrenzung für die Anzahl der Unterstrings angibt, die im Array enthalten sein sollen. Wenn angegeben, teilt es den String bei jedem Auftreten des angegebenen separator, stoppt jedoch, wenn limit Einträge im Array platziert wurden. Jeglicher verbleibender Text wird überhaupt nicht im Array aufgenommen.

  • Das Array kann weniger Einträge enthalten als limit, wenn das Ende des Strings erreicht ist, bevor das Limit erreicht wird.
  • Wenn limit 0 ist, wird [] zurückgegeben.

Rückgabewert

Wenn separator ein String ist, wird ein Array von Strings zurückgegeben, das an jedem Punkt geteilt wird, an dem der separator im angegebenen String auftritt.

Wenn separator ein regulärer Ausdruck ist, enthält das zurückgegebene Array auch die erfassten Gruppen für jedes Vorkommen des Separators; siehe unten für Details. Die erfassten Gruppen können nicht übereinstimmend sein, in diesem Fall sind sie im Array undefined.

Wenn separator eine benutzerdefinierte [Symbol.split]() Methode hat, wird dessen Rückgabewert direkt zurückgegeben.

Beschreibung

Wenn separator ein nicht-leerer String ist, wird das Ziel-String durch alle Vorkommen des separator geteilt, ohne dass der separator in das Ergebnis eingeschlossen wird. Zum Beispiel könnte ein String, der Tab-getrennte Werte (TSV) enthält, analysiert werden, indem ein Tabulatorzeichen als Separator übergeben wird, wie myString.split("\t"). Wenn der separator aus mehreren Zeichen besteht, muss diese gesamte Zeichenfolge gefunden werden, um zu teilen. Wenn der separator am Anfang (oder Ende) des Strings erscheint, hat er immer noch die Wirkung des Teilens, was zu einem leeren (d.h. null langen) String an der ersten (oder letzten) Position des zurückgegebenen Arrays führt. Wenn separator in str nicht vorkommt, enthält das zurückgegebene Array ein Element, das aus dem gesamten String besteht.

Wenn separator ein leerer String ("") ist, wird str in ein Array jedes seiner UTF-16 „Zeichen“ umgewandelt, ohne leere Strings an beiden Enden des resultierenden Strings.

Hinweis: "".split("") ist daher der einzige Weg, um ein leeres Array zu erzeugen, wenn ein String als separator übergeben wird und limit nicht 0 ist.

Warnung: Wenn der leere String ("") als Separator verwendet wird, wird der String nicht durch benutzerwahrgenommene Zeichen (graphemische Cluster) oder Unicode-Zeichen (Codepunkte) geteilt, sondern durch UTF-16 Code-Einheiten. Dies zerstört Surrogatpaare. Siehe "Wie verwandelt man einen String in ein Zeichen-Array in JavaScript?" auf Stack Overflow.

Wenn separator ein regulärer Ausdruck ist, der leere Strings matcht, hängt es davon ab, ob der Match durch UTF-16 Code-Einheiten oder Unicode-Codepunkte geteilt wird, ob der Regex Unicode-bewusst ist.

js
"😄😄".split(/(?:)/); // [ "\ud83d", "\ude04", "\ud83d", "\ude04" ]
"😄😄".split(/(?:)/u); // [ "😄", "😄" ]

Wenn separator ein regulärer Ausdruck mit erfassten Gruppen ist, werden bei jedem Vorkommen des separator die erfassten Gruppen (einschließlich aller undefined Ergebnisse) in das Ausgabearray eingefügt. Dieses Verhalten wird durch die [Symbol.split] Methode des Regex festgelegt.

Wenn separator ein Objekt mit einer Symbol.split Methode ist, wird diese Methode mit dem Zielstring und limit als Argumente aufgerufen, und this wird auf das Objekt gesetzt. Dessen Rückgabewert wird der Rückgabewert von split.

Jeder andere Wert wird in einen String umgewandelt, bevor er als Separator verwendet wird.

Beispiele

Verwendung von split()

Wenn der String leer ist und ein nicht-leerer Separator angegeben ist, gibt split() [""] zurück. Wenn der String und der Separator beide leere Strings sind, wird ein leeres Array zurückgegeben.

js
const emptyString = "";

// string is empty and separator is non-empty
console.log(emptyString.split("a"));
// [""]

// string and separator are both empty strings
console.log(emptyString.split(emptyString));
// []

Das folgende Beispiel definiert eine Funktion, die einen String in ein Array von Strings aufteilt, indem sie separator verwendet. Nach dem Teilen des Strings gibt die Funktion Meldungen aus, die den ursprünglichen String (vor dem Teilen), den verwendeten Separator, die Anzahl der Elemente im Array und die einzelnen Array-Elemente anzeigen.

js
function splitString(stringToSplit, separator) {
  const arrayOfStrings = stringToSplit.split(separator);

  console.log("The original string is:", stringToSplit);
  console.log("The separator is:", separator);
  console.log(
    "The array has",
    arrayOfStrings.length,
    "elements:",
    arrayOfStrings.join(" / "),
  );
}

const tempestString = "Oh brave new world that has such people in it.";
const monthString = "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec";

const space = " ";
const comma = ",";

splitString(tempestString, space);
splitString(tempestString);
splitString(monthString, comma);

Dieses Beispiel erzeugt die folgende Ausgabe:

The original string is: "Oh brave new world that has such people in it."
The separator is: " "
The array has 10 elements: Oh / brave / new / world / that / has / such / people / in / it.

The original string is: "Oh brave new world that has such people in it."
The separator is: "undefined"
The array has 1 elements: Oh brave new world that has such people in it.

The original string is: "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"
The separator is: ","
The array has 12 elements: Jan / Feb / Mar / Apr / May / Jun / Jul / Aug / Sep / Oct / Nov / Dec

Entfernen von Leerzeichen aus einem String

Im folgenden Beispiel sucht split() nach null oder mehr Leerzeichen, gefolgt von einem Semikolon, gefolgt von null oder mehr Leerzeichen — und entfernt, wenn gefunden, die Leerzeichen und das Semikolon aus dem String. nameList ist das als Ergebnis von split() zurückgegebene Array.

js
const names = "Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand ";

console.log(names);

const re = /\s*(?:;|$)\s*/;
const nameList = names.split(re);

console.log(nameList);

Dies protokolliert zwei Zeilen; die erste Zeile protokolliert den ursprünglichen String, und die zweite Zeile protokolliert das resultierende Array.

Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand
[ "Harry Trump", "Fred Barney", "Helen Rigby", "Bill Abel", "Chris Hand", "" ]

Rückgabe einer begrenzten Anzahl von Splits

Im folgenden Beispiel sucht split() nach Leerzeichen in einem String und gibt die ersten 3 Splits zurück, die es findet.

js
const myString = "Hello World. How are you doing?";
const splits = myString.split(" ", 3);

console.log(splits); // [ "Hello", "World.", "How" ]

Splitten mit einem RegExp, um Teile des Separators im Ergebnis einzuschließen

Wenn separator ein regulärer Ausdruck ist, der Klammern ( ) enthält, werden übereinstimmende Ergebnisse im Array aufgenommen.

js
const myString = "Hello 1 word. Sentence number 2.";
const splits = myString.split(/(\d)/);

console.log(splits);
// [ "Hello ", "1", " word. Sentence number ", "2", "." ]

Hinweis: \d entspricht der Zeichenklasse für Ziffern zwischen 0 und 9.

Verwendung eines benutzerdefinierten Splitters

Ein Objekt mit einer Symbol.split Methode kann als benutzerdefinierter Splitter verwendet werden.

Das folgende Beispiel teilt einen String unter Verwendung eines internen Zustands, der aus einer inkrementierenden Zahl besteht:

js
const splitByNumber = {
  [Symbol.split](str) {
    let num = 1;
    let pos = 0;
    const result = [];
    while (pos < str.length) {
      const matchPos = str.indexOf(num, pos);
      if (matchPos === -1) {
        result.push(str.substring(pos));
        break;
      }
      result.push(str.substring(pos, matchPos));
      pos = matchPos + String(num).length;
      num++;
    }
    return result;
  },
};

const myString = "a1bc2c5d3e4f";
console.log(myString.split(splitByNumber)); // [ "a", "bc", "c5d", "e", "f" ]

Das folgende Beispiel verwendet einen internen Zustand, um bestimmtes Verhalten zu erzwingen und sicherzustellen, dass ein "gültiges" Ergebnis erzielt wird.

js
const DELIMITER = ";";

// Split the commands, but remove any invalid or unnecessary values.
const splitCommands = {
  [Symbol.split](str, lim) {
    const results = [];
    const state = {
      on: false,
      brightness: {
        current: 2,
        min: 1,
        max: 3,
      },
    };
    let pos = 0;
    let matchPos = str.indexOf(DELIMITER, pos);

    while (matchPos !== -1) {
      const subString = str.slice(pos, matchPos).trim();

      switch (subString) {
        case "light on":
          // If the `on` state is already true, do nothing.
          if (!state.on) {
            state.on = true;
            results.push(subString);
          }
          break;

        case "light off":
          // If the `on` state is already false, do nothing.
          if (state.on) {
            state.on = false;
            results.push(subString);
          }
          break;

        case "brightness up":
          // Enforce a brightness maximum.
          if (state.brightness.current < state.brightness.max) {
            state.brightness.current += 1;
            results.push(subString);
          }
          break;

        case "brightness down":
          // Enforce a brightness minimum.
          if (state.brightness.current > state.brightness.min) {
            state.brightness.current -= 1;
            results.push(subString);
          }
          break;
      }

      if (results.length === lim) {
        break;
      }

      pos = matchPos + DELIMITER.length;
      matchPos = str.indexOf(DELIMITER, pos);
    }

    // If we broke early due to reaching the split `lim`, don't add the remaining commands.
    if (results.length < lim) {
      results.push(str.slice(pos).trim());
    }

    return results;
  },
};

const commands =
  "light on; brightness up; brightness up; brightness up; light on; brightness down; brightness down; light off";
console.log(commands.split(splitCommands, 3)); // ["light on", "brightness up", "brightness down"]

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-string.prototype.split

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
split

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch