KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

RegExp.prototype.test — controleren op een overeenkomst

De methode test() controleert of een reguliere expressie overeenkomt met tekst en geeft true of false terug. De flags g en y zorgen ervoor dat de zoekactie lastIndex gebruikt, waardoor opeenvolgende aanroepen verschillende resultaten kunnen opleveren.

Versie: 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)

Roep RegExp.prototype.test aan als regexp.test(string). De methode geeft true terug als er een overeenkomst wordt gevonden, en anders false. Vastgelegde groepen geeft de methode niet terug; gebruik daarvoor exec(). Het argument wordt omgezet naar tekst. Als je het argument weglaat, wordt het de tekst "undefined".

Standaard is het voldoende als een deel van de tekst overeenkomt. Gebruik de ankers ^ en $ om de overeenkomst te beperken tot de grenzen van de invoer. Houd er rekening mee dat de flag m deze ankers verandert in grenzen van regels.

Met de standaardimplementatie van exec() gebruiken de flags g en y de waarde van lastIndex om de startpositie te bepalen. Met g kan de zoekactie ook latere posities proberen, maar met y zoekt die niet verder. Als lastIndex in Unicode-modus (met u of v) naar het lage surrogaat van een UTF-16-surrogaatpaar wijst, kan een overeenkomst bij het voorafgaande hoge surrogaat beginnen, ook met y. Bij succes wordt lastIndex ingesteld op het einde van de overeenkomst; bij mislukking wordt de waarde op nul gezet. Als geen van beide flags is ingesteld, leest de standaardimplementatie van exec() toch lastIndex en past ToLength toe op de gelezen waarde. Als die omzetting slaagt, begint de zoekactie op positie 0 zonder de eigenschap lastIndex te wijzigen. Wijs je echter een waarde van het type Symbol toe aan lastIndex, dan gooit test() ook zonder g of y een TypeError. Voor onafhankelijke controles laat je g en y weg of stel je vóór elke aanroep lastIndex = 0 in.

Een lege overeenkomst verhoogt lastIndex niet automatisch: een lus op basis van test() kan daardoor blijven doorgaan. De methode gebruikt exec(), dus het overschrijven ervan kan het gedrag veranderen. Dit is een API van de ECMAScript-taal, geen browser-API.

Voorbeelden

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"));

Resultaat

true
3
false
0
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen