KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.match — overeenkomsten met reguliere expressies

De methode match() zoekt overeenkomsten van een reguliere expressie in een tekenreeks. De vlag g verandert de vorm van het resultaat: zonder die vlag krijg je hoogstens één overeenkomst met vastgelegde groepen; met die vlag krijg je een array met volledige overeenkomsten. Geen overeenkomst levert null op.

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

string.match(regexp)

String.prototype.match zoekt naar overeenkomsten met een patroon in een tekenreeks zonder die tekenreeks te wijzigen. Bij een standaard RegExp-object is het resultaat een array of null als er niets overeenkomt. Controleer of het resultaat niet null is voordat je de elementen ervan gebruikt.

Als noch g noch y is ingesteld, geeft de methode de eerste overeenkomst terug, als die er is. Met y maar zonder g probeert de methode alleen een overeenkomst te vinden die precies begint op de positie die ontstaat door ToLength toe te passen op de huidige waarde van lastIndex. Daardoor kan de methode een latere overeenkomst teruggeven, of null terwijl het patroon elders in de tekenreeks wel overeenkomt. Als lastIndex bij /a/y bijvoorbeeld op -1 staat, vindt het patroon in 'a' een overeenkomst op index 0. Bij een overeenkomst zonder g bevat element 0 de volledige overeenkomst en bevatten de volgende elementen de vastgelegde groepen. De eigenschap index geeft de positie van de overeenkomst in UTF-16-code-eenheden aan, en input bevat de doorzochte tekenreeks. Met g bevat de array volledige, niet-overlappende overeenkomsten, maar geen vastgelegde groepen of die metadata. Zonder y kan de zoekopdracht stukken tussen overeenkomsten overslaan. Met zowel g als y stopt de zoekopdracht zodra het patroon op de huidige positie niet overeenkomt. Zo geeft 'a a'.match(/a/gy) alleen ['a'] terug, hoewel er op index 2 nog een a staat. Gebruik matchAll() om de groepen bij meerdere overeenkomsten te behouden.

Een tekenreeksargument wordt geïnterpreteerd als een patroon voor een reguliere expressie, niet als letterlijke tekst: "abc".match(".")[0] levert "a" op. Als je het argument weglaat of undefined meegeeft, ontstaat een leeg patroon. Het resultaat is dus een overeenkomst met de lege tekenreeks, niet null.

Technisch gezien delegeert de methode aan Symbol.match als het argument die methode aanbiedt. Een aangepaste implementatie kan daardoor een ander type resultaat teruggeven; het hierboven beschreven arraygedrag geldt voor het standaardgedrag van RegExp.

Voorbeelden

const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));

Resultaat

["item-12","12",0]
["item-12","item-34"]
null

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