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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.