Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Syntax šablónových literálov s tagom

Funkcia tagu dostáva textové časti šablónového literálu a hodnoty dosadzovaných výrazov oddelene. Návratová hodnota funkcie je hodnotou celého výrazu.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

tag`prefix ${expression} suffix`
obj.tag`prefix ${expression} suffix`

function tag(strings, ...values) { /* process the parts and return a value */ }

V zápise tag`prefix ${expression} suffix` stojí výraz tag pred literálom ohraničeným spätnými apostrofmi. JavaScript zavolá tag bez toho, aby najprv zostavil reťazec. V zápise tag(`prefix ${expression} suffix`) naopak literál bez tagu prevedie dosadzované hodnoty na reťazce a spojí ich s textom. Funkcia dostane jediný hotový reťazec.

Prvým argumentom tagu je pole strings s textovými časťami. JavaScript vyhodnotí výrazy ${...} pred volaním zľava doprava a ich hodnoty odovzdá ako samostatné argumenty bez prevodu na reťazce. Možno ich zachytiť parametrom ...values. Pri n dosadeniach má pole n + 1 častí vrátane prípadných prázdnych častí. Hodnotou výrazu je to, čo tag vráti; nemusí to byť reťazec.

V strings[i] sú escape sekvencie spracované (cooked), kým strings.raw[i] zachováva ich zápis. Chybná escape sekvencia v literáli s tagom spôsobí, že celý zodpovedajúci prvok strings má hodnotu undefined; bez tagu vznikne SyntaxError. Obe polia sú zmrazené. Pri opakovanom vyhodnotení toho istého výskytu literálu v tom istom prostredí ECMAScript (realm) sa používa to isté pole strings. Iný výskyt má vlastné pole, aj keď je text totožný.

V zápise obj.tag`x` sa obj odovzdá ako hodnota this, rovnako ako pri bežnom volaní metódy. Ak hodnotu tagu nemožno zavolať, vznikne TypeError. Priame použitie voliteľného reťazenia, napríklad obj?.tag`x` , spôsobí SyntaxError.

Ide o syntax jazyka definovanú v ECMAScripte 2024, nie o rozhranie API prehliadača. Over podporu v cieľovom prostredí. Samotný tag dáta nečistí: neodovzdávaj nedôveryhodný výstup do innerHTML bez vhodnej sanitizácie HTML.

Prí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ýsledok

{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}

`inspect` vráti objekt, ktorý `JSON.stringify` prevedie na reťazec na výpis. `\n` je jeden znak nového riadka v `strings[0]`, ale dva znaky v `strings.raw[0]`. Hodnota `7` zostáva číslom a posledná časť je prázdna.

Súvisiace lekcie

  • JavaScript · Lekcia 28 · Pokročilá · Verzia: 4

Zdroje