Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Skladnja označenih šablonskih literalov

Označevalna funkcija ločeno prejme besedilne dele šablonskega literala in vrednosti vstavljenih izrazov. Njena vrnjena vrednost je vrednost celotnega izraza.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

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

V zapisu tag`prefix ${expression} suffix` je izraz tag pred literalom, omejenim s krativcema. JavaScript pokliče označevalno funkcijo, ne da bi najprej sestavil niz. Pri zapisu tag(`prefix ${expression} suffix`) pa neoznačeni literal pretvori vstavljene vrednosti v nize in jih združi z besedilom. Funkcija tako prejme en sam že sestavljen niz.

Prvi argument označevalne funkcije je polje strings z besedilnimi deli. JavaScript pred klicem ovrednoti izraze ${...} od leve proti desni in njihove vrednosti poda kot ločene argumente, ne da bi jih pretvoril v nize. Zbere jih lahko parameter za preostale argumente, kot je ...values. Pri n vstavitvah je n + 1 delov, vključno z morebitnimi praznimi. Vrednost izraza je vrednost, ki jo funkcija vrne, in ni nujno niz.

V strings[i] so ubežna zaporedja interpretirana (cooked), strings.raw[i] pa ohrani njihov zapis. Neveljavno ubežno zaporedje v označenem literalu pomeni, da ima celoten ustrezni element strings vrednost undefined; brez oznake povzroči SyntaxError. Obe polji sta zamrznjeni. Pri ponovnem vrednotenju iste pojavitve literala v istem okolju ECMAScript (realm) se uporabi isto polje strings. Druga pojavitev ima svoje polje, tudi če je besedilo enako.

V zapisu obj.tag`x` klic poda obj kot vrednost this, tako kot pri običajnem klicu metode. Če vrednosti oznake ni mogoče poklicati, nastane TypeError. Neposredna uporaba izbirnega veriženja, na primer obj?.tag`x` , povzroči SyntaxError.

To je skladnja jezika, določena v ECMAScriptu 2024, in ne brskalniški API. Preveri podporo v ciljnem izvajalnem okolju. Označevanje samo po sebi ne očisti podatkov: nezaupanja vrednega rezultata ne podaj v innerHTML brez ustreznega čiščenja HTML-ja.

Primeri

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}`));

Rezultat

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

`inspect` vrne objekt, ki ga `JSON.stringify` pretvori v niz za izpis. `\n` je v `strings[0]` en znak za novo vrstico, v `strings.raw[0]` pa sta to dva znaka. Vrednost `7` ostane število, zadnji del pa je prazen.

Povezane lekcije

  • JavaScript · Lekcija 28 · Napredna · Različica: 4

Viri