Baseline Widely available
Die test()
-Methode von RegExp
-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 gibt true
zurück, wenn eine Ãbereinstimmung gefunden wird, andernfalls false
.
JavaScript-RegExp
-Objekte sind zustandsbehaftet, wenn sie die Flags global
oder sticky
gesetzt haben (z.B. /foo/g
oder /foo/y
). Sie speichern einen lastIndex
aus dem vorherigen Treffer. Intern verwendet kann test()
verwendet werden, um über mehrere Ãbereinstimmungen in einem Textstring zu iterieren (mit Erfassungsgruppen).
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 Parameter
str
Der String, gegen den der reguläre Ausdruck abgeglichen werden soll. Alle Werte werden in Strings umgewandelt, daher führt das Weglassen oder Ãbergeben von undefined
dazu, dass test()
nach dem String "undefined"
sucht, was selten gewünscht ist.
true
, wenn eine Ãbereinstimmung zwischen dem regulären Ausdruck und dem String str
besteht. Andernfalls false
.
Verwenden Sie test()
, wann immer Sie wissen möchten, ob ein Muster in einem String gefunden wird. test()
gibt einen booleschen Wert zurück, anders als die String.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 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 regulären Ausdrucksinstanz aufgerufen, über den vorherigen Treffer hinausgehen.
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 das global-Flag gesetzt hat, wird test()
den lastIndex
des Regex vorwärts 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 erhöht, wenn test()
true
zurückgibt.
Hinweis: Solange test()
true
zurückgibt, wird lastIndex
nicht zurückgesetztâeven bei einem Test mit einem anderen String!
Wenn test()
false
zurückgibt, wird die lastIndex
-Eigenschaft des aufrufenden Regex auf 0
zurückgesetzt.
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-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4