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