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

CKTIS / JavaScript

String.raw — необработени части на шаблонни низове

String.raw е статичен метод, използван като таг на шаблонен низ. Той запазва изписването на последователности като \n в буквалните текстови части, но продължава да изчислява изразите ${...} и да вмъква стойностите им.

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

Синтаксис

String.raw`text${expression}text`
String.raw(template, ...substitutions)

String.raw е статичен метод, а не метод на отделен низ. Като таг на шаблонен низ той съединява необработените буквални текстови части със заместванията. Последователност \n в буквална част дава обратна наклонена черта и буквата n, а не знак за нов ред.

Изразите в ${...} продължават да се изчисляват, а стойностите им се преобразуват в низове. Необработената обработка се отнася за буквалните части, а не за заместванията: ако заместена стойност вече съдържа знак за нов ред, той си остава такъв. Методът не отменя по-ранна обработка на escape последователности и не осигурява безопасно кодиране за HTML или SQL.

Възможно е и обикновено извикване String.raw(template, ...substitutions). Методът чете template.raw като обект, подобен на масив, и преплита елементите му със заместванията. Липсващите замествания не добавят нищо, допълнителните се пренебрегват, а raw с дължина нула създава празен низ. Липсващ raw или стойност null причинява TypeError.

В примера първият ред съдържа буквално \n, вторият потвърждава съдържанието на низа, а третият показва пропуснатото заместване между B и C.

Примери

const name = "Ada";
const text = String.raw`Hello\n${name}!`;
console.log(text);
console.log(text === "Hello\\nAda!");
console.log(String.raw({ raw: ["A", "B", "C"] }, 7));

Резултат

Hello\nAda!
true
A7BC

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

Източници