CKTIS / JavaScript
String.prototype.replace — замяна на текст
replace() връща текст със заменени съвпадения, без да променя оригинала. Научете разликата между търсене с низове и регулярни изрази, както и между шаблони за замяна и функции за замяна.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
text.replace(searchValue, replaceValue)String.prototype.replace с обикновен низ или стандартен RegExp връща нов низ; оригиналът остава непроменен. Ако няма съвпадение, съдържанието се връща без промяна. Това е API на езика ECMAScript, а не API на браузъра.
Низов searchValue се третира буквално и заменя само първото срещане; празен низ съвпада в началото. Стандартен RegExp без g заменя най-много едно съвпадение; с g заменя всички намерени съвпадения. Обект с метод [Symbol.replace] може да зададе собствено поведение, включително резултата.
Низов replaceValue тълкува $$ като $, $& като цялото съвпадение и $1 като първата съществуваща група за улавяне. Функцията за замяна получава съвпадението, след това уловените групи, индекса и входния низ; при именувани групи накрая се добавя обект groups. Индексът брои UTF-16 кодови единици. Резултатът от функцията се преобразува в низ, но последователностите $ не се тълкуват.
Примерът сравнява замяна само на първото съвпадение, глобална замяна, препратка към уловена група и буквалния резултат от функция. Извеждането на text също показва, че оригиналът остава непроменен.
Примери
const text = "cat cat";
console.log(text.replace("cat", "dog"));
console.log(text.replace(/cat/g, "dog"));
console.log(text.replace(/(cat)/g, "[$1]"));
console.log(text.replace(/cat/g, () => "$&"));
console.log(text);Резултат
dog cat dog dog [cat] [cat] $& $& cat cat
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.