CKTIS / JavaScript
RegExp.prototype.test — Übereinstimmung prüfen
Die Methode test() prüft, ob ein regulärer Ausdruck auf einen Text passt, und gibt true oder false zurück. Mit den Flags g und y wird lastIndex für die Suche verwendet, sodass wiederholte Aufrufe unterschiedliche Ergebnisse liefern können.
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
regexp.test(string)RegExp.prototype.test rufst du als regexp.test(string) auf. Die Methode gibt true zurück, wenn eine Übereinstimmung gefunden wird, andernfalls false. Erfasste Gruppen gibt sie nicht zurück; dafür kannst du exec() verwenden. Das Argument wird in einen Text umgewandelt. Wird das Argument weggelassen, wird daraus der Text "undefined".
Standardmäßig reicht es aus, wenn ein Teil des Textes passt. Um die Übereinstimmung auf die Grenzen der Eingabe zu beschränken, verwende die Anker ^ und $. Beachte, dass das Flag m sie zu Zeilengrenzen macht.
Bei der standardmäßigen Implementierung von exec() wird mit g und mit y die Startposition anhand von lastIndex bestimmt. Mit g kann die Suche auch spätere Positionen prüfen, mit y dagegen nicht. Zeigt lastIndex im Unicode-Modus (mit u oder v) auf das niedrige Surrogat eines UTF-16-Surrogatpaars, kann eine Übereinstimmung auch mit y beim davorliegenden hohen Surrogat beginnen. Bei Erfolg wird lastIndex auf das Ende der Übereinstimmung gesetzt, bei einem Fehlschlag auf null zurückgesetzt. Ist keines der beiden Flags gesetzt, liest die Standardimplementierung von exec() trotzdem lastIndex und wendet ToLength auf den gelesenen Wert an. Gelingt die Umwandlung, beginnt die Suche an Position 0, ohne die Eigenschaft lastIndex zu ändern. Weist du lastIndex jedoch einen Wert vom Typ Symbol zu, löst test() auch ohne g oder y einen TypeError aus. Für voneinander unabhängige Prüfungen lässt du g und y weg oder setzt vor jedem Aufruf lastIndex = 0.
Eine leere Übereinstimmung erhöht lastIndex nicht automatisch: Eine Schleife mit test() kann dadurch endlos laufen. Die Methode verwendet exec(), daher kann eine Überschreibung dieser Methode das Verhalten ändern. Dies ist eine API der ECMAScript-Sprache, keine Browser-API.
Beispiele
const pattern = /cat/g;
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
pattern.lastIndex = 0;
console.log(pattern.test("cat"));Ergebnis
true 3 false 0 true
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.