Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

RegExp.prototype.flags — odczytywanie flag wyrażenia regularnego

Właściwość flags zwraca flagi wyrażenia regularnego jako napis w ustalonej kolejności, niezależnie od kolejności podanej podczas tworzenia. Jest akcesorem bez settera, a nie metodą.

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

regexp.flags

RegExp.prototype.flags jest właściwością akcesorową odczytywaną przez regexp.flags, bez nawiasów wywołania. Zwraca napis zawierający włączone flagi; przy braku flag wynikiem jest pusty napis "". Nie zwraca wzorca ani otaczających go ukośników.

Litery są zwracane w ustalonej kolejności dgimsuvy, z pominięciem wyłączonych flag, a nie w kolejności zapisu. Getter odczytuje kolejno właściwości hasIndices, global, ignoreCase, multiline, dotAll, unicode, unicodeSets i sticky, odpowiadające tym literom. Wyniki odczytu są konwertowane na wartości logiczne. Obsługa samego flags nie dowodzi obsługi każdej z nowszych flag w danym silniku.

Akcesor nie ma settera: przypisanie do regexp.flags nie zmienia flag wyrażenia; przy zwykłej instancji w trybie ścisłym powoduje TypeError. Aby użyć innych flag, utwórz nowe wyrażenie, np. new RegExp(regexp.source, "g"). Getter odczytuje publiczne właściwości, więc ich nadpisanie może zmienić raportowany wynik bez zmiany działania dopasowywania.

Przykład pokazuje normalizację kolejności: /cat/mi zwraca im. JSON.stringify sprawia, że pusty napis zwracany dla /cat/ jest widoczny jako "".

Przykłady

const regexp = /cat/mi;
console.log(regexp.flags);
console.log(JSON.stringify(/cat/.flags));

Wynik

im
""

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

Źródła