Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Literał wyrażenia regularnego

Literał wyrażenia regularnego (RegExp literal) zapisuje wzorzec bezpośrednio w kodzie jako /pattern/flags. Tworzy obiekt RegExp, którego można użyć do sprawdzania tekstu, wyszukiwania lub zastępowania dopasowań.

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

Literał wyrażenia regularnego, czyli RegExp literal, ma postać /pattern/flags, bez cudzysłowów. Ukośniki wyznaczają granice wzorca, a opcjonalne flagi zmieniają sposób dopasowania. Każde obliczenie literału tworzy nowy obiekt RegExp, nawet gdy jego treść się nie zmienia.

W przykładzie ^ oznacza początek tekstu, $ jego koniec, a \d+ co najmniej jedną cyfrę ASCII. Flaga i ignoruje wielkość liter. Metoda test() zwraca wartość logiczną. Bez flag g i y kolejne wywołania nie przesuwają pozycji wyszukiwania przez lastIndex.

Literał nie wymaga podwajania ukośnika odwrotnego właściwego dla łańcuchów: /\d+/ odpowiada new RegExp("\\d+"). Konstruktor pozwala budować wzorzec z tekstu w czasie wykonania. Aby dopasować / poza klasą znaków, zapisz \/. Nie umieszczaj w literale surowego znaku końca wiersza; użyj np. \n. Zapis // rozpoczyna komentarz, a nie pusty wzorzec; pusty wzorzec można zapisać jako /(?:)/.

Niepoprawny wzorzec lub niepoprawne flagi literału powodują SyntaxError przed wykonaniem kodu. Flagi nie mogą się powtarzać, a u i v wzajemnie się wykluczają. Obsługa nowszych flag zależy od silnika; przykład nie używa takich rozszerzeń ani API przeglądarki.

Przykłady

const pattern = /^item-\d+$/i;
console.log(pattern.test("ITEM-42"));
console.log(pattern.test("item-x"));

Wynik

true
false

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

Źródła