RegExp.prototype.test()

Probieren Sie es aus

const str = "table football";

const regex = /fo+/;
const globalRegex = /fo+/g;

console.log(regex.test(str));
// Expected output: true

console.log(globalRegex.lastIndex);
// Expected output: 0

console.log(globalRegex.test(str));
// Expected output: true

console.log(globalRegex.lastIndex);
// Expected output: 9

console.log(globalRegex.test(str));
// Expected output: false

Syntax

test(str)

Parameter

str

Der String, gegen den der regulre Ausdruck abgeglichen werden soll. Alle Werte werden in Strings umgewandelt, daher fhrt das Weglassen oder bergeben von undefined dazu, dass test() nach dem String "undefined" sucht, was selten gewnscht ist.

Rckgabewert

true, wenn eine bereinstimmung zwischen dem regulren Ausdruck und dem String str besteht. Andernfalls false.

Beschreibung

Verwenden Sie test(), wann immer Sie wissen mchten, ob ein Muster in einem String gefunden wird. test() gibt einen booleschen Wert zurck, anders als die String.prototype.search()-Methode (die den Index einer bereinstimmung oder -1 zurckgibt, wenn keine gefunden wird).

Um mehr Informationen zu erhalten (aber mit langsamerer Ausfhrung), verwenden Sie die exec()-Methode. (Dies ist hnlich wie die String.prototype.match()-Methode.)

Wie bei exec() (oder in Kombination damit) wird test(), mehrmals auf derselben globalen regulren Ausdrucksinstanz aufgerufen, ber den vorherigen Treffer hinausgehen.

Beispiele

Verwendung von test()

Dieses Beispiel berprft, ob "hello" ganz am Anfang eines Strings enthalten ist und gibt einen booleschen Wert zurck.

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

console.log(result); // true

Das folgende Beispiel protokolliert eine Nachricht, die von der erfolgreichen Durchfhrung des Tests abhngt:

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 das global-Flag gesetzt hat, wird test() den lastIndex des Regex vorwrts verschieben. (RegExp.prototype.exec() verschiebt die lastIndex-Eigenschaft ebenfalls.)

Weitere Aufrufe von test(str) werden die Suche in str ab lastIndex fortsetzen. Die lastIndex-Eigenschaft wird jedes Mal erhht, wenn test() true zurckgibt.

Wenn test() false zurckgibt, wird die lastIndex-Eigenschaft des aufrufenden Regex auf 0 zurckgesetzt.

Das folgende Beispiel demonstriert dieses Verhalten:

const regex = /foo/g; // the "global" flag is set

// regex.lastIndex is at 0
regex.test("foo"); // true

// regex.lastIndex is now at 3
regex.test("foo"); // false

// regex.lastIndex is at 0
regex.test("barfoo"); // true

// regex.lastIndex is at 6
regex.test("foobar"); // false

// regex.lastIndex is at 0
regex.test("foobarfoo"); // true

// regex.lastIndex is at 3
regex.test("foobarfoo"); // true

// regex.lastIndex is at 9
regex.test("foobarfoo"); // false

// regex.lastIndex is at 0
// (...and so on)

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Leitfaden zu regulren Ausdrcken
• RegExp