CKTIS / JavaScript
RegExp.prototype.test — проверка за съвпадение
Методът test() проверява дали даден регулярен израз съвпада с текст и връща true или false. Флаговете g и y карат търсенето да използва lastIndex, затова повторните извиквания могат да дават различни резултати.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
regexp.test(string)Извиквай RegExp.prototype.test като regexp.test(string). Методът връща true, ако намери съвпадение, и false в противен случай. Не връща заснетите групи; за тях използвай exec(). Аргументът се преобразува в текст. Ако аргументът е пропуснат, той става текстът "undefined".
По подразбиране е достатъчно да съвпада част от текста. За да ограничиш съвпадението до границите на входа, използвай котвите ^ и $, като имаш предвид, че флагът m ги превръща в граници на редове.
При стандартната реализация на exec() флаговете g и y използват lastIndex, за да определят началната позиция. С g търсенето може да провери и следващи позиции, но с y не продължава напред. Ако в режим Unicode (с u или v) lastIndex сочи към ниския сурогат от сурогатна двойка в UTF-16, съвпадението може да започне от предхождащия го висок сурогат дори с y. При успех lastIndex се задава на края на съвпадението, а при неуспех се нулира. Дори когато не е зададен нито един от двата флага, стандартната реализация на exec() прочита lastIndex и прилага операцията ToLength върху прочетената стойност. Ако преобразуването е успешно, търсенето започва от позиция 0, без да променя свойството lastIndex. Ако обаче присвоиш на lastIndex стойност от тип Symbol, test() хвърля изключение TypeError дори без g и y. За независими проверки пропусни g и y или задай lastIndex = 0 преди всяко извикване.
Празното съвпадение не премества автоматично lastIndex: цикъл, основан на test(), може да не завърши. Методът използва exec(), така че предефинирането му може да промени поведението. Това е API на езика ECMAScript, а не API на браузъра.
Примери
const pattern = /cat/g;
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
pattern.lastIndex = 0;
console.log(pattern.test("cat"));Резултат
true 3 false 0 true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.