WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.match — Treffer regulärer Ausdrücke

Die Methode match() findet Treffer eines regulären Ausdrucks in einer Zeichenkette. Das Flag g ändert die Ergebnisform: Ohne es erhältst du höchstens einen Treffer samt Erfassungsgruppen, mit ihm ein Array vollständiger Treffer. Gibt es keinen Treffer, wird null zurückgegeben.

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.match(regexp)

String.prototype.match sucht in einer Zeichenkette nach Treffern eines Musters, ohne die Zeichenkette zu verändern. Bei einem standardmäßigen RegExp-Objekt ist das Ergebnis ein Array oder null, wenn nichts passt. Prüfe vor dem Zugriff auf die Ergebniselemente, ob das Ergebnis null ist.

Sind weder g noch y gesetzt, gibt die Methode den ersten Treffer zurück, sofern es einen gibt. Ist y, aber nicht g gesetzt, sucht die Methode nur nach einem Treffer, der genau an der Position beginnt, die sich aus der Umwandlung des aktuellen Werts von lastIndex mit ToLength ergibt. Sie kann also einen späteren Treffer liefern oder null zurückgeben, obwohl das Muster an einer anderen Stelle der Zeichenkette passt. Ist etwa bei /a/y der Wert von lastIndex auf -1 gesetzt, findet das Muster in 'a' einen Treffer an Index 0. Bei einem Treffer ohne g enthält Element 0 den vollständigen Treffer, die folgenden Elemente enthalten die Erfassungsgruppen. Die Eigenschaft index gibt die Position des Treffers in UTF-16-Codeeinheiten an, und input enthält die durchsuchte Zeichenkette. Mit g enthält das Array vollständige, nicht überlappende Treffer, aber weder Erfassungsgruppen noch diese Metadaten. Ohne y kann die Suche Lücken zwischen Treffern überspringen. Sind g und y beide gesetzt, endet die Suche, sobald das Muster an der aktuellen Position nicht passt. So gibt 'a a'.match(/a/gy) nur ['a'] zurück, obwohl an Index 2 ein weiteres a steht. Um die Gruppen für mehrere Treffer zu behalten, verwende matchAll().

Ein Zeichenkettenargument wird als Muster eines regulären Ausdrucks interpretiert, nicht als wörtlicher Text: "abc".match(".")[0] ergibt "a". Wird das Argument weggelassen oder undefined übergeben, entsteht ein leeres Muster. Das Ergebnis ist daher ein Treffer für die leere Zeichenkette und nicht null.

Technisch delegiert die Methode an Symbol.match, sofern das Argument diese Methode bereitstellt. Eine eigene Implementierung kann daher einen anderen Ergebnistyp zurückgeben; das oben beschriebene Array-Verhalten gilt für das standardmäßige Verhalten von RegExp.

Beispiele

const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));

Ergebnis

["item-12","12",0]
["item-12","item-34"]
null

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.

Quellen