CKTIS / JavaScript
Flagi RegExp g/i/m/u i sekwencje właściwości Unicode
Dowiedz się, jak łączyć flagi wyszukiwania globalnego, ignorowania wielkości liter, trybu wielowierszowego i trybu Unicode oraz dopasowywać znaki według ich właściwości Unicode.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
/pattern/gimu
new RegExp(patternString, "gimu")
/\p{Letter}/u
/\P{Letter}/u
/\p{Script_Extensions=Greek}/u
new RegExp("\\p{Letter}", "u")W literale /pattern/gimu flagi zapisuje się po końcowym ukośniku, a w new RegExp(patternString, "gimu") podaje się je jako drugi argument. Gdy wzorzec jest zwykłym literałem tekstowym, podwój ukośnik odwrotny: new RegExp("\\p{Letter}", "u"). Powtórzone lub nierozpoznawane flagi powodują SyntaxError.
g oznacza wyszukiwanie globalne: text.match(re) zwraca wszystkie pełne dopasowania, a przy ich braku null. Każde wywołanie exec() lub test() zwraca wynik tylko jednej próby znalezienia dopasowania. Z g wyszukiwanie zaczyna się od lastIndex, po sukcesie zapisuje tam koniec dopasowania, a po niepowodzeniu zeruje tę właściwość. lastIndex mierzy się w jednostkach kodowych UTF-16 nawet z u. Przy ponownym użyciu wyrażenia do niezależnego wyszukiwania ustaw lastIndex na 0 albo utwórz nowy obiekt.
i ignoruje wielkość liter bez reguł zależnych od języka; z u stosuje proste składanie wielkości liter Unicode (case folding). m pozwala kotwicom ^ i $ dopasować się również tuż po i tuż przed separatorem wiersza, odpowiednio. Nie sprawia, że . dopasowuje separatory wierszy — za to odpowiada s. u włącza tryb oparty na punktach kodowych Unicode i zaostrza składnię wzorca; punkt kodowy nie musi być całym znakiem postrzeganym przez użytkownika.
W trybie u sekwencja \p{L} dopasowuje punkt kodowy z kategorii Letter, a \P{L} jej dopełnienie, gdy nie ma flagi i. Można podać parę nazwa–wartość, np. \p{Script_Extensions=Greek}. Obsługiwane nazwy, wartości i aliasy odróżniają wielkość liter; nieprawidłowy zapis powoduje SyntaxError w trybie Unicode. Bez u ani v sekwencje \p i \P oznaczają zwykłe p i P. v też obsługuje sekwencje właściwości, ale nie można go łączyć z u. Sprawdź obsługę w docelowym środowisku wykonawczym.
Przykłady
const text = "TAG:É\nTag:\u{10400}\nTAG:7\nxTag:Ω";
console.log(JSON.stringify(text.match(/^tag:\p{L}$/gimu)));Wynik
["TAG:É","Tag:𐐀"]
`g` zbiera oba dopasowania, `i` pozwala dopasować `TAG` i `Tag`, a `m` sprawdza kotwice na granicach wierszy. Z `u` wyrażenie `\p{L}` dopasowuje zarówno `É`, jak i `𐐀` jako pojedyncze punkty kodowe. Wiersz z `7` odpada, bo cyfra nie jest literą, a `xTag:Ω` nie zaczyna się od `tag:`.
Powiązane lekcje
- JavaScript · Lekcja 25 · Średniozaawansowany · Wersja: 3
Źródła
- ECMAScript 2024 Language Specification — Patterns
- ECMAScript 2024 Language Specification — RegExpInitialize
- ECMAScript 2024 Language Specification — RegExpBuiltinExec
- ECMAScript 2024 Language Specification — RegExp.prototype [ @@match ]
- Unicode character class escape: \p{...}, \P{...} — MDN
- RegExp() constructor — MDN