Dietest()-Methode vonRegExp-Instanzen führt eine Suche mit diesem regulären Ausdruck durch, um nach einer Übereinstimmung zwischen einem regulären Ausdruck und einem angegebenen String zu suchen. Sie gibttrue zurück, wenn eine Übereinstimmung gefunden wird, andernfallsfalse.

JavaScript-RegExp-Objekte sindzustandsbehaftet, wenn sie die Flagsglobal odersticky gesetzt haben (z.B./foo/g oder/foo/y). Sie speichern einenlastIndex aus dem vorherigen Treffer. Intern verwendet kanntest() verwendet werden, um über mehrere Übereinstimmungen in einem Textstring zu iterieren (mit Erfassungsgruppen).

Probieren Sie es aus

const str = "table football";const regex = /fo+/;const globalRegex = /fo+/g;console.log(regex.test(str));// Expected output: trueconsole.log(globalRegex.lastIndex);// Expected output: 0console.log(globalRegex.test(str));// Expected output: trueconsole.log(globalRegex.lastIndex);// Expected output: 9console.log(globalRegex.test(str));// Expected output: false

Syntax

test(str)

Parameter

str

Der String, gegen den der reguläre Ausdruck abgeglichen werden soll. Alle Werte werdenin Strings umgewandelt, daher führt das Weglassen oder Übergeben vonundefined dazu, dasstest() nach dem String"undefined" sucht, was selten gewünscht ist.

Rückgabewert

true, wenn eine Übereinstimmung zwischen dem regulären Ausdruck und dem Stringstr besteht. Andernfallsfalse.

Beschreibung

Verwenden Sietest(), wann immer Sie wissen möchten, ob ein Muster in einem String gefunden wird.test() gibt einen booleschen Wert zurück, anders als dieString.prototype.search()-Methode (die den Index einer Übereinstimmung oder-1 zurückgibt, wenn keine gefunden wird).

Um mehr Informationen zu erhalten (aber mit langsamerer Ausführung), verwenden Sie dieexec()-Methode. (Dies ist ähnlich wie dieString.prototype.match()-Methode.)

Wie beiexec() (oder in Kombination damit) wirdtest(), mehrmals auf derselben globalen regulären Ausdrucksinstanz aufgerufen, über den vorherigen Treffer hinausgehen.

Beispiele

Verwendung von test()

Dieses Beispiel überprüft, ob"hello" ganz am Anfang eines Strings enthalten ist und gibt einen booleschen Wert zurück.

const str = "hello world!";const result = /^hello/.test(str);console.log(result); // true

Das folgende Beispiel protokolliert eine Nachricht, die von der erfolgreichen Durchführung des Tests abhängt:

function testInput(re, str) {  const midString = re.test(str) ? "contains" : "does not contain";  console.log(`${str} ${midString} ${re.source}`);}

Verwendung von test() bei einem Regex mit dem "global"-Flag

Wenn ein Regex dasglobal-Flag gesetzt hat, wirdtest() denlastIndex des Regex vorwärts verschieben. (RegExp.prototype.exec() verschiebt dielastIndex-Eigenschaft ebenfalls.)

Weitere Aufrufe vontest(str) werden die Suche instr ablastIndex fortsetzen. DielastIndex-Eigenschaft wird jedes Mal erhöht, wenntest()true zurückgibt.

Wenntest()false zurückgibt, wird dielastIndex-Eigenschaft des aufrufenden Regex auf0 zurückgesetzt.

Das folgende Beispiel demonstriert dieses Verhalten:

const regex = /foo/g; // the "global" flag is set// regex.lastIndex is at 0regex.test("foo"); // true// regex.lastIndex is now at 3regex.test("foo"); // false// regex.lastIndex is at 0regex.test("barfoo"); // true// regex.lastIndex is at 6regex.test("foobar"); // false// regex.lastIndex is at 0regex.test("foobarfoo"); // true// regex.lastIndex is at 3regex.test("foobarfoo"); // true// regex.lastIndex is at 9regex.test("foobarfoo"); // false// regex.lastIndex is at 0// (...and so on)

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Leitfaden zu regulären Ausdrücken
• RegExp