CKTIS / JavaScript
Синтаксис на шаблонните литерали с таг
Функцията таг получава отделно текстовите части на шаблонния литерал и стойностите на вмъкнатите изрази. Върнатата от функцията стойност е стойността на целия израз.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
tag`prefix ${expression} suffix`
obj.tag`prefix ${expression} suffix`
function tag(strings, ...values) { /* process the parts and return a value */ }В записа tag`prefix ${expression} suffix` изразът tag стои пред литерал, ограден с обратни кавички. JavaScript извиква тага, без първо да сглобява низ. При tag(`prefix ${expression} suffix`) литералът без таг преобразува вмъкнатите стойности в низове и ги съединява с текста. Функцията получава един готов низ.
Първият аргумент на тага е масивът strings с текстовите части. Преди извикването JavaScript изчислява изразите ${...} отляво надясно и подава стойностите им като отделни аргументи, без да ги преобразува в низове. Остатъчен параметър като ...values може да ги събере. При n вмъквания има n + 1 части, включително празните. Стойността на израза е това, което тагът връща, и не е задължително да е низ.
В strings[i] екраниращите последователности са обработени (cooked), а strings.raw[i] запазва начина, по който са изписани. Невалидна екранираща последователност в литерал с таг задава undefined за целия съответен елемент на strings; без таг причинява SyntaxError. И двата масива са замразени. При повторно изпълнение на същото срещане на литерала в една и съща среда на ECMAScript (realm) се използва същият масив strings. Друго срещане има собствен масив, дори текстът да е еднакъв.
В записа obj.tag`x` извикването подава obj като стойност на this, както при обикновено извикване на метод. Ако стойността на тага не може да се извика, възниква TypeError. Прякото използване на условно верижно обръщение (optional chaining), например obj?.tag`x` , води до SyntaxError.
Това е синтаксис на езика, описан в ECMAScript 2024, а не браузърен API. Провери поддръжката в целевата среда за изпълнение. Тагът сам по себе си не пречиства данните: не подавай ненадежден резултат към innerHTML без подходящо пречистване на HTML.
Примери
function inspect(strings, value) {
return {
cookedLength: strings[0].length,
rawLength: strings.raw[0].length,
valueType: typeof value,
tail: strings[1],
};
}
console.log(JSON.stringify(inspect`\n${7}`));Резултат
{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}`inspect` връща обект, който `JSON.stringify` преобразува в низ за извеждане. `\n` е един знак за нов ред в `strings[0]`, но два знака в `strings.raw[0]`. Стойността `7` остава число, а последната част е празна.
Свързани уроци
- JavaScript · Урок 28 · Напреднало · Версия: 4