String.prototype.split()

separator

Das Muster, das beschreibt, wo jede Teilung erfolgen soll. Kann undefined, ein String oder ein Objekt mit einer Symbol.split Methode sein – das typische Beispiel ist ein regulärer Ausdruck. Wenn separator weggelassen wird oder undefined übergeben wird, bewirkt split(), dass ein Array mit dem aufrufenden String als einzigem Element zurückgegeben wird. Alle Werte, die nicht undefined oder Objekte mit einer [Symbol.split]() Methode sind, werden in Strings umgewandelt.

limit Optional

Eine nicht-negative Ganzzahl, die ein Limit für die Anzahl der im Array enthaltenen Teilstrings angibt. Gibt dies an, teilt sich der String bei jedem Vorkommen des angegebenen separator, stoppt jedoch, wenn limit Einträge im Array platziert wurden. Jeglicher restlicher Text wird überhaupt nicht im Array enthalten sein.

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

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

Wenn separator ein Regex 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 übereinstimmen, in diesem Fall sind sie undefined im Array.

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

Wenn separator ein nicht-leerer String ist, wird der Zielstring durch alle Vorkommen des separator geteilt, ohne separator in die Ergebnisse einzubeziehen. Ein String, der z. B. tabulatorgetrennte Werte (TSV) enthält, könnte analysiert werden, indem ein Tabulatorzeichen als Separator übergeben wird, z. B. myString.split("\t"). Wenn separator mehrere Zeichen enthält, muss diese gesamte Zeichenfolge gefunden werden, um zu teilen. Wenn separator am Anfang (oder Ende) des Strings erscheint, hat es trotzdem die Wirkung zu teilen, was zu einem leeren (d.h. null-längen) String führt, der an der ersten (oder letzten) Position des zurückgegebenen Arrays erscheint. Wenn separator nicht in str 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“ konvertiert, ohne leere Strings an beiden Enden des resultierenden Strings.

Wenn separator ein Regex ist, das leere Strings matcht, hängt es davon ab, ob mit UTF-16 Codeeinheiten oder Unicode Codepunkten geteilt wird, ob das Regex Unicode-bewusst ist.

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

Wenn separator ein regulärer Ausdruck mit erfassten Gruppen ist, dann werden jedes Mal, wenn ein separator eintritt, die erfassten Gruppen (einschließlich aller undefined Resultate) in das Ausgabe-Array eingefügt. Dieses Verhalten wird von der [Symbol.split]() Methode des Regex spezifiziert.

Wenn separator ein Objekt mit einer [Symbol.split]() Methode ist, wird diese Methode mit dem Zielstring und limit als Argumente aufgerufen und this auf das Objekt gesetzt. Sein Rückgabewert wird zum Rückgabewert von split.

Jeder andere Wert wird vor der Verwendung als Separator in einen String umgewandelt.

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.

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 anhand des separator teilt. Nachdem der String geteilt wurde, protokolliert die Funktion Nachrichten, die den Originalstring (vor der Teilung), den verwendeten Separator, die Anzahl der Elemente im Array und die einzelnen Array-Elemente angeben.

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

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 Array, das als Ergebnis von split() zurückgegeben wird.

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 Originalstring 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", "" ]

Im folgenden Beispiel sucht split() nach Leerzeichen in einem String und gibt die ersten 3 gefundenen Teilungen zurück.

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

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

Wenn separator ein regulärer Ausdruck ist, der erfasste Klammern ( ) enthält, werden die gematchten Ergebnisse im Array enthalten.

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

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

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

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

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 ein bestimmtes Verhalten durchzusetzen und um ein "gültiges" Ergebnis sicherzustellen.

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"]

• Polyfill von String.prototype.split in core-js mit Fixes und Implementierung von modernem Verhalten wie Symbol.split Unterstützung
• es-shims Polyfill von String.prototype.split
• Leitfaden für reguläre Ausdrücke
• String.prototype.charAt()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()
• Array.prototype.join()