Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Flagi wyrażeń regularnych: dotAll (`s`), `u`, `i` i `g`

Flagi `s`, `u`, `i` i `g` sterują odpowiednio dopasowaniem kropki do końców wierszy, trybem Unicode, ignorowaniem wielkości liter i wyszukiwaniem globalnym.

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

Składnia

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

Flagi zapisuj po zamykającym ukośniku literału (/a.b/gsui) albo w drugim argumencie konstruktora (new RegExp("a.b", "gsui")). Kolejność flag nie ma znaczenia; nieznana lub powtórzona flaga powoduje SyntaxError. Właściwości dotAll, unicode, ignoreCase i global pokazują stan flag s, u, i i g; nie służą do ich zmiany. Reguły te obowiązują w ECMAScript 2024, ale wsparcie zależy od środowiska wykonawczego.

s (dotAll) sprawia, że kropka . jako metaznak dopasowuje również znaki końca wiersza: \n, \r, U+2028 i U+2029. Nie zmienia działania kotwic ^ i $; to m pozwala im dopasowywać także granice wierszy. Zapis \. nadal oznacza dosłowną kropkę.

u włącza tryb Unicode: kropka traktuje prawidłową parę surogatów, np. 😄, jako jeden punkt kodowy, a nie dwie jednostki UTF-16. Punkt kodowy nie zawsze jest całym grafemem, czyli znakiem postrzeganym przez użytkownika. u zaostrza też składnię i nie można go łączyć z v (SyntaxError). i ignoruje wielkość liter; z u stosuje proste ujednolicanie wielkości liter Unicode, niezależne od ustawień językowych i bez rozwijania ß do ss.

g umożliwia iterację po nienakładających się dopasowaniach. Wbudowane exec() z g (bez y) używa lastIndex jako pozycji w jednostkach UTF-16 do ustalenia początku wyszukiwania. W trybie Unicode, jeśli ta pozycja wypada wewnątrz prawidłowej pary surogatów, dopasowanie może zacząć się na początku tej pary, przed lastIndex. Po sukcesie exec() zapisuje w lastIndex koniec dopasowania w jednostkach UTF-16, a po niepowodzeniu ustawia 0. test() również może zmieniać ten stan, więc przed niezależnym wyszukiwaniem wyzeruj lastIndex lub użyj nowego obiektu RegExp. Puste dopasowanie może zatrzymać pętlę z exec() w miejscu. String.prototype.matchAll() wymaga g dla obiektu RegExp (TypeError bez g), obsługuje postęp po pustych dopasowaniach i iteruje na kopii, której początkowy lastIndex jest ustawiony na bieżący lastIndex oryginału.

Przykłady

{
  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));
}

Wynik

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

Pierwszy wiersz pokazuje oba dopasowania. W drugim usuwamy kolejno `s`, `u` i `i`, za każdym razem z pełnego zestawu flag: znika dopasowanie przez koniec wiersza, dopasowanie z emoji albo dopasowanie z wielką literą. Trzeci wiersz pokazuje `lastIndex` po dwóch sukcesach i jednym niepowodzeniu.

Powiązane lekcje

  • JavaScript · Lekcja 10 · Zaawansowany · Wersja: 4

Źródła