RegExp.prototype[Symbol.split]()

str

Das Ziel der Teilungsoperation.

limit Optional

Ein Integer, der ein Limit für die Anzahl an gefundener Teilungen angibt. Die [Symbol.split]()-Methode teilt weiterhin bei jedem Treffer des this-RegExp-Musters (oder, in der oben stehenden Syntax, regexp), bis die Anzahl der Teilungselemente das limit erreicht oder der String nicht mehr dem this-Muster entspricht.

Ein Array, das Teilstrings als seine Elemente enthält. Erfasste Gruppen sind enthalten.

Diese Methode wird intern in String.prototype.split() aufgerufen, wenn ein RegExp als Trennzeichen übergeben wird. Zum Beispiel liefern die folgenden beiden Beispiele das gleiche Ergebnis.

"a-b-c".split(/-/);

/-/[Symbol.split]("a-b-c");

Diese Methode existiert, um das Verhalten von split() in RegExp-Unterklassen anzupassen.

Die RegExp.prototype[Symbol.split]() Basismethode zeigt die folgenden Verhaltensweisen:

• Sie beginnt, indem sie [Symbol.species] verwendet, um ein neues RegExp zu erstellen, wodurch verhindert wird, dass das ursprüngliche RegExp in irgendeiner Weise verändert wird.
• Das g ("global")-Flag des RegExp wird ignoriert, und das y ("sticky")-Flag wird immer angewendet, selbst wenn es ursprünglich nicht vorhanden war.
• Wenn der Zielstring leer ist und das RegExp leere Strings abgleichen kann (zum Beispiel /a?/), wird ein leeres Array zurückgegeben. Andernfalls wird, wenn das RegExp keinen leeren String abgleichen kann, [""] zurückgegeben.
• Die Übereinstimmung erfolgt, indem kontinuierlich this.exec() aufgerufen wird. Da das RegExp immer sticky ist, bewegt es sich entlang des Strings und liefert jedes Mal einen übereinstimmenden String, einen Index und alle erfassten Gruppen.
• Für jede Übereinstimmung wird zunächst der Teilstring zwischen dem Ende des letzten übereinstimmenden Strings und dem Anfang des aktuell übereinstimmenden Strings dem Ergebnisarray hinzugefügt. Danach werden die Werte der erfassten Gruppen einzeln hinzugefügt.
• Wenn die aktuelle Übereinstimmung ein leerer String ist oder wenn das RegExp bei der aktuellen Position nicht übereinstimmt (da es sticky ist), wird der lastIndex dennoch verschoben - wenn das Regex Unicode-fähig ist, wird um einen Unicode-Codepunkt verschoben; andernfalls um eine UTF-16-Codeeinheit.
• Wenn das RegExp nicht mit dem Zielstring übereinstimmt, wird der Zielstring unverändert in ein Array gewrappt zurückgegeben.
• Die Länge des zurückgegebenen Arrays übersteigt niemals den limit Parameter, falls angegeben, während versucht wird, so nah wie möglich zu sein. Daher können die letzte Übereinstimmung und ihre erfassten Gruppen möglicherweise nicht alle im zurückgegebenen Array enthalten sein, wenn das Array bereits gefüllt ist.

Diese Methode kann auf fast die gleiche Weise verwendet werden wie String.prototype.split(), außer dem unterschiedlichen this und der unterschiedlichen Reihenfolge der Argumente.

const re = /-/g;
const str = "2016-01-02";
const result = re[Symbol.split](str);
console.log(result); // ["2016", "01", "02"]

Unterklassen von RegExp können die [Symbol.split]()-Methode überschreiben, um das Standardverhalten zu verändern.

class MyRegExp extends RegExp {
  [Symbol.split](str, limit) {
    const result = RegExp.prototype[Symbol.split].call(this, str, limit);
    return result.map((x) => `(${x})`);
  }
}

const re = new MyRegExp("-");
const str = "2016-01-02";
const result = str.split(re); // String.prototype.split calls re[Symbol.split]().
console.log(result); // ["(2016)", "(01)", "(02)"]

• Polyfill von RegExp.prototype[Symbol.split] in core-js
• String.prototype.split()
• RegExp.prototype[Symbol.match]()
• RegExp.prototype[Symbol.matchAll]()
• RegExp.prototype[Symbol.replace]()
• RegExp.prototype[Symbol.search]()
• RegExp.prototype.exec()
• RegExp.prototype.test()
• Symbol.split