CKTIS / JavaScript
RegExp — reguliere expressies
RegExp beschrijft patronen om tekst te doorzoeken. Leer over flags, groepen, tekenklassen, kwantoren en velden van het resultaat van exec(), waaronder benoemde captures, indexbereiken en het statusafhankelijke gedrag van lastIndex.
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
/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)RegExp stelt een tekstpatroon voor. Maak er een met /pattern/flags of new RegExp("pattern", "flags"); constructorstrings vereisen een extra niveau van escaping van backslashes: /\d+/ komt overeen met new RegExp("\\d+"). test() retourneert een boolean; exec() retourneert een matcharray of null. Dit artikel behandelt RegExp-flags, groepen, klassen, kwantoren en resultaatvelden.
Flags: g maakt opeenvolgende matches mogelijk, i negeert hoofdletters, m laat ^ en $ regeleinden herkennen, s laat . overeenkomen met regeleindetekens, u schakelt de Unicode-modus in, v breidt die modus uit met bewerkingen op tekensets, y vereist een match precies op lastIndex en d voegt indexbereiken toe. u en v sluiten elkaar uit; dubbele of onbekende flags veroorzaken een SyntaxError.
Klassen zoals [a-z], [^0-9] en \d selecteren tekens; \d betekent ASCII-cijfers. Groepen (…) leggen tekst vast, (?<name>…) geeft een capture een naam en (?:…) legt niets vast. De kwantoren *, +, ? en {n,m} betekenen nul of meer, één of meer, nul of één en tussen n en m herhalingen. Standaard zijn ze hebzuchtig; een afsluitende ? maakt ze lui.
Een exec()-resultaat bevat de volledige match bij [0], captures vanaf [1], de beginpositie in index, de oorspronkelijke tekst in input en benoemde captures in groups, of undefined als er geen benoemde groepen zijn. Captures zonder overeenkomst hebben de waarde undefined. Alleen met de flag d bevat de matcharray een array indices: indices[0] is het indexpaar voor de volledige match, en de volgende elementen bevatten de paren voor de bijbehorende captures of undefined voor captures die geen deel uitmaakten van de match. Elk paar geeft een bereik [start,end) (exclusief de eindpositie) in UTF-16-code-eenheden, net als index en lastIndex. Als het patroon geen benoemde captures bevat, is indices.groups gelijk aan undefined. Anders is het een object dat elke capturenaam koppelt aan het bijbehorende indexpaar of aan undefined als die capture geen deel uitmaakte van de match.
Met g of y veranderen zowel exec() als test() lastIndex: bij succes wordt het einde van de match ingesteld; bij mislukking wordt de waarde op nul gezet. Een lege match verhoogt deze waarde in exec() niet automatisch, waardoor een lus mogelijk niet eindigt. Benoemde groepen horen bij ES2018, d bij ES2022 en v bij ES2024. Dit zijn ECMAScript-functies, geen Web-API's; controleer de ondersteuning in de doelbrowser onafhankelijk van Node 24 in de repository.
Voorbeelden
const re = /(?<key>[a-z]+)=(\d{2})/dg;
const text = "id=42";
const m = re.exec(text);
if (m === null) throw new Error("Expected a match");
console.log(JSON.stringify({
match: m[0],
captures: [m[1], m[2]],
key: m.groups.key,
index: m.index,
input: m.input,
span: m.indices[0],
keySpan: m.indices.groups.key,
lastIndex: re.lastIndex
}));Resultaat
{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}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.