Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje