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

CKTIS / JavaScript

String.prototype.match — съвпадения с регулярни изрази

Методът match() търси съвпадения с регулярен израз в низ. Флагът g променя формата на резултата: без него получавате най-много едно съвпадение със захващащите групи, а с него — масив от пълни съвпадения. При липса на съвпадение резултатът е null.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

string.match(regexp)

String.prototype.match търси съвпадения с шаблон в низ, без да променя низа. При стандартен обект RegExp резултатът е масив или null, ако нищо не съвпада. Проверете дали резултатът не е null, преди да достъпите елементите му.

Когато не е зададен нито g, нито y, методът връща първото съвпадение, ако има такова. С y, но без g, методът търси съвпадение, което започва точно на позицията, получена след преобразуване на текущата стойност на lastIndex чрез операцията ToLength. Затова може да върне по-късно съвпадение или да върне null, дори ако има съвпадение на друго място в низа. Например, ако за /a/y стойността на lastIndex е -1, шаблонът намира съвпадение на индекс 0 в низа 'a'. При намерено съвпадение без g елемент 0 съдържа цялото съвпадение, а следващите елементи съдържат захващащите групи. Свойството index показва позицията на съвпадението в UTF-16 кодови единици, а input съдържа търсения низ. С g масивът съдържа пълни, неприпокриващи се съвпадения, но не включва захващащите групи или тези метаданни. Без y търсенето може да прескача участъците между съвпаденията. Когато са зададени и g, и y, търсенето спира веднага щом няма съвпадение на текущата позиция. Например 'a a'.match(/a/gy) връща само ['a'], въпреки че на индекс 2 има още едно a. За да запазите групите при множество съвпадения, използвайте matchAll().

Аргумент от тип низ се интерпретира като шаблон на регулярен израз, а не като буквален текст: "abc".match(".")[0] дава "a". Пропускането на аргумента или подаването на undefined създава празен шаблон, така че резултатът е съвпадение с празния низ, а не null.

Технически методът делегира на Symbol.match, ако аргументът предоставя този метод. Затова персонализирана реализация може да върне различен тип резултат; описаното по-горе поведение с масив се отнася до стандартното поведение на RegExp.

Примери

const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));

Резултат

["item-12","12",0]
["item-12","item-34"]
null

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

Източници