Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

RegExp — wyrażenia regularne

RegExp opisuje wzorce wyszukiwania w tekście. Poznaj flagi, grupy, klasy znaków, kwantyfikatory oraz pola wyniku exec(), w tym nazwane przechwycenia, zakresy indeksów i stan lastIndex.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)

RegExp reprezentuje wzorzec tekstowy. Twórz go jako /pattern/flags albo new RegExp("pattern", "flags"); w łańcuchu konstruktora trzeba dodatkowo ekranować ukośniki odwrotne: /\d+/ odpowiada new RegExp("\\d+"). test() zwraca wartość logiczną, a exec() tablicę dopasowania lub null.

Flagi: g włącza wyszukiwanie kolejnych dopasowań, i ignoruje wielkość liter, m zmienia działanie ^ i $ na granice wierszy, s pozwala . dopasować terminatory wierszy, u włącza tryb Unicode, v rozszerza tryb Unicode o operacje na zbiorach znaków, y wymaga dopasowania dokładnie od lastIndex, a d dodaje zakresy indeksów. u i v wzajemnie się wykluczają; powtórzone lub nieznane flagi powodują SyntaxError.

Klasy [a-z], [^0-9] i \d wybierają znaki; \d oznacza cyfry ASCII. Grupy (…) przechwytują tekst, (?<name>…) nadają przechwyceniu nazwę, a (?:…) nie przechwytują. Kwantyfikatory *, +, ? i {n,m} oznaczają odpowiednio zero lub więcej, jeden lub więcej, zero lub jeden oraz od n do m powtórzeń. Domyślnie są zachłanne; końcowe ? wybiera wariant leniwy.

W wyniku exec() pole [0] zawiera całe dopasowanie, [1] i dalsze — przechwycenia, index — pozycję początku, input — tekst wejściowy, a groups — nazwane przechwycenia lub undefined. Niedopasowane przechwycenia mają wartość undefined. Tylko z flagą d tablica dopasowania zawiera tablicę indices: indices[0] to para indeksów całego dopasowania, a kolejne elementy zawierają pary dla poszczególnych grup przechwytujących lub undefined, jeśli dana grupa nie uczestniczyła w dopasowaniu. Każda para wyznacza zakres [start,end) (bez pozycji końcowej) w jednostkach kodowych UTF-16, których używają też index i lastIndex. Jeśli wzorzec nie zawiera nazwanych grup przechwytujących, indices.groups ma wartość undefined. W przeciwnym razie jest to obiekt, w którym każdej nazwie grupy odpowiada para indeksów lub undefined, jeśli ta grupa nie uczestniczyła w dopasowaniu.

Przy g lub y zarówno exec(), jak i test() zmieniają lastIndex: sukces ustawia koniec dopasowania, porażka zeruje tę właściwość. Dopasowanie puste nie przesuwa jej automatycznie w exec(), więc pętla może się nie zakończyć. Nazwane grupy pochodzą z ES2018, d z ES2022, a v z ES2024. To funkcje ECMAScript, nie Web API; sprawdź obsługę w docelowej przeglądarce, niezależnie od Node 24 w repozytorium.

Przykłady

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

Wynik

{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła