CKTIS / JavaScript
Syntaxe šablonových literálů s tagem
Funkce tagu dostává textové části šablonového literálu a hodnoty dosazovaných výrazů odděleně. Návratová hodnota funkce je hodnotou celého výrazu.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
tag`prefix ${expression} suffix`
obj.tag`prefix ${expression} suffix`
function tag(strings, ...values) { /* process the parts and return a value */ }V zápisu tag`prefix ${expression} suffix` stojí výraz tag před literálem uzavřeným ve zpětných apostrofech. JavaScript zavolá funkci tagu, aniž by nejprve vytvořil řetězec. V zápisu tag(`prefix ${expression} suffix`) naopak literál bez tagu převede dosazované hodnoty na řetězce a spojí je s textem. Funkce tak dostane jediný hotový řetězec.
Prvním argumentem tagu je pole strings s textovými částmi. Výrazy ${...} JavaScript vyhodnotí před voláním zleva doprava a jejich hodnoty předá jako samostatné argumenty bez převodu na řetězce. Lze je zachytit parametrem ...values. Při n dosazeních má pole n + 1 částí, včetně případných prázdných. Hodnotou výrazu je to, co tag vrátí; nemusí to být řetězec.
V strings[i] jsou escape sekvence zpracované (cooked), zatímco strings.raw[i] zachovává jejich zápis. Chybná escape sekvence v literálu s tagem způsobí, že celý odpovídající prvek strings má hodnotu undefined; bez tagu nastane SyntaxError. Obě pole jsou zmrazená. Při opakovaném vyhodnocení téhož výskytu literálu ve stejném prostředí ECMAScript (realm) se používá stejné pole strings. Jiný výskyt má vlastní pole, i když je text totožný.
V zápisu obj.tag`x` se obj předává jako hodnota this, stejně jako při běžném volání metody. Pokud hodnotu tagu nelze zavolat, nastane TypeError. Přímé použití volitelného řetězení, například obj?.tag`x` , způsobí SyntaxError.
Jde o syntaxi jazyka definovanou v ECMAScriptu 2024, nikoli o API prohlížeče. Ověř podporu v cílovém běhovém prostředí. Tag sám data nečistí: nepředávej nedůvěryhodný výstup do innerHTML bez vhodné sanitizace HTML.
Příklady
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}`));Výsledek
{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}`inspect` vrátí objekt, který `JSON.stringify` převede na řetězec pro výpis. `\n` je jeden znak nového řádku v `strings[0]`, ale dva znaky v `strings.raw[0]`. Hodnota `7` zůstává číslem a závěrečná část je prázdná.
Související lekce
- JavaScript · Lekce 28 · Pokročilá · Verze: 4