База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Флагове на регулярните изрази: dotAll (`s`), `u`, `i` и `g`

Флаговете `s`, `u`, `i` и `g` управляват съответно поведението на точката при нов ред, режима Unicode, различаването на главни и малки букви и глобалното търсене.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Поставяй флаговете след затварящата наклонена черта на литерала (/a.b/gsui) или във втория аргумент на конструктора (new RegExp("a.b", "gsui")). Редът им няма значение; непознат или повторен флаг води до SyntaxError. Свойствата dotAll, unicode, ignoreCase и global показват дали са зададени s, u, i и g; те не ги променят. Тези правила важат в ECMAScript 2024, но поддръжката зависи от средата за изпълнение.

С s (dotAll) метасимволът . съвпада и с четирите знака за край на ред: \n, \r, U+2028 и U+2029. Това не променя котвите ^ и $; m им позволява да съвпадат и с границите на редовете. Записът \. продължава да означава буквална точка.

u включва режим Unicode: точката обработва валидна сурогатна двойка като 😄 като една кодова точка, а не като две кодови единици на UTF-16. Кодовата точка не е непременно цяла графема, тоест знак, който потребителят възприема като едно цяло. u налага и по-строг синтаксис и не може да се комбинира с v (SyntaxError). i не различава главни и малки букви; с u използва опростено уеднаквяване на регистъра по Unicode, независимо от регионалните настройки и без да разширява ß до ss.

g позволява обхождане на незастъпващи се съвпадения. С g и без y вграденият метод exec() използва lastIndex като позиция в кодови единици на UTF-16, за да определи откъде да започне търсенето. Ако в режим Unicode тази позиция попада във валидна сурогатна двойка, съвпадението може да започне от началото на двойката, преди lastIndex. При успех exec() записва в lastIndex края на съвпадението като позиция в кодови единици на UTF-16, а при неуспех задава 0. test() също може да променя това състояние. За независимо търсене занули lastIndex или използвай нов обект RegExp. Празно съвпадение може да попречи на цикъл с exec() да напредне. За аргумент от тип RegExp методът String.prototype.matchAll() изисква g (иначе TypeError), продължава след празни съвпадения и обхожда съвпаденията чрез копие, чийто начален lastIndex се задава според текущата стойност на lastIndex на оригинала.

Примери

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

Резултат

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

Първият ред показва и двете съвпадения. На втория ред от пълния набор се премахва по един флаг — `s`, `u` и `i` поред: отпада съвпадението през новия ред, това с емоджито или това с главната буква. Третият ред показва `lastIndex` след две успешни и едно неуспешно търсене.

Свързани уроци

  • JavaScript · Урок 10 · Напреднало · Версия: 4

Източници