JavaScript/Objekte/String/matchAll

Die Methode String.matchAll() durchsucht eine Zeichenkette mit Hilfe eines regulären Ausdrucks und liefert ein Iterator aller Ergebnisse zurück, auf die der reguläre Ausdruck passt.

Syntax

String.matchAll(regexp)

• regexp: Ein Objekt des regulären Ausdrucks oder ein beliebiges Objekt, das über eine Symbol.matchAll-Methode verfügt.
  • Wenn regexp kein RegExp-Objekt ist und keine Symbol.matchAll-Methode hat, wird es implizit in ein RegExp konvertiert, indem new RegExp(regexp, 'g') verwendet wird.
  • Wenn regexp ein regex ist, muss das globale (g) Flag gesetzt sein, oder es wird ein TypeError ausgelöst.

Rückgabewert

Ein iterierbares Iterator-Objekt (das nicht neu gestartet werden kann) mit Übereinstimmungen. Jede Übereinstimmung ist ein Array mit der gleichen Form wie der Rückgabewert von RegExp.prototype.exec().

Erwartet als Parameter den regulären Ausdruck.

Weblinks

• ECMAScript 2015 (6th Edition, ECMA-262): String.matchAll()
• MDN: String.matchAll()