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

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници