KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Vlaggen voor reguliere expressies: dotAll (`s`), `u`, `i` en `g`

De vlaggen `s`, `u`, `i` en `g` regelen respectievelijk het gedrag van de punt bij regeleinden, de Unicode-modus, hoofdlettergevoeligheid en globaal zoeken.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

/pattern/gsui
new RegExp("pattern", "gsui")
re.dotAll; re.unicode; re.ignoreCase; re.global; re.lastIndex

Zet vlaggen na de afsluitende schuine streep van een literal (/a.b/gsui) of in het tweede argument van de constructor (new RegExp("a.b", "gsui")). De volgorde maakt niet uit; een onbekende of dubbele vlag veroorzaakt een SyntaxError. De eigenschappen dotAll, unicode, ignoreCase en global geven aan of s, u, i en g zijn ingesteld; ze veranderen de vlaggen niet. Deze regels gelden in ECMAScript 2024, maar de ondersteuning verschilt per runtime.

Met s (dotAll) komt de wildcard . ook overeen met de vier regeleindetekens: \n, \r, U+2028 en U+2029. Dit verandert de ankers ^ en $ niet; met m komen die ook overeen met regelgrenzen. \. blijft een letterlijke punt.

u schakelt de Unicode-modus in: een punt behandelt een geldig surrogaatpaar zoals 😄 als één codepunt in plaats van twee UTF-16-code-eenheden. Een codepunt is niet altijd een volledig grafeem, oftewel wat een gebruiker als één teken ervaart. u maakt de syntaxis ook strenger en kan niet samen met v worden gebruikt (SyntaxError). i negeert verschillen tussen hoofdletters en kleine letters; samen met u gebruikt het Unicode simple case folding, onafhankelijk van de landinstellingen en zonder ß uit te breiden tot ss.

Met g kun je niet-overlappende treffers doorlopen. Met g en zonder y gebruikt de ingebouwde methode exec() lastIndex als offset in UTF-16-code-eenheden om te bepalen waar de zoekactie begint. Als die offset in de Unicode-modus binnen een geldig surrogaatpaar valt, kan een treffer aan het begin van dat paar starten, vóór lastIndex. Bij een treffer slaat exec() het einde op in lastIndex als offset in UTF-16-code-eenheden; bij een mislukking zet het lastIndex terug op 0. Ook test() kan deze status wijzigen. Zet voor een onafhankelijke zoekactie lastIndex terug op 0 of gebruik een nieuw RegExp-object. Een lege treffer kan een exec()-lus laten vastlopen. String.prototype.matchAll() vereist g voor een RegExp-argument (anders TypeError), gaat verder na lege treffers en gebruikt een kopie waarvan de initiële lastIndex wordt ingesteld op de huidige waarde van die van het origineel.

Voorbeelden

{
  const text = "a\nb A😄b";
  const re = /a.b/gsui;
  const collect = (pattern) => Array.from(text.matchAll(pattern), (m) => m[0]);

  console.log(JSON.stringify(collect(re)));
  console.log(JSON.stringify([/a.b/gui, /a.b/gsi, /a.b/gsu].map(collect)));

  const positions = [];
  for (let n = 0; n < 3; n++) {
    re.exec(text);
    positions.push(re.lastIndex);
  }
  console.log(JSON.stringify(positions));
}

Resultaat

["a\nb","A😄b"]
[["A😄b"],["a\nb"],["a\nb"]]
[3,8,0]

De eerste regel toont beide treffers. Op de tweede regel wordt telkens één vlag uit de volledige set weggelaten: `s`, `u` of `i`. Daardoor verdwijnt de treffer over het regeleinde, met de emoji of met de hoofdletter. De derde regel toont `lastIndex` na twee treffers en één mislukking.

Gerelateerde lessen

  • JavaScript · Les 10 · Gevorderd · Versie: 4

Bronnen