CKTIS / JavaScript
Sintaksa označenih predložnih literala
Funkcija oznake zasebno prima tekstualne dijelove predložnog literala i vrijednosti umetnutih izraza. Njezina povratna vrijednost vrijednost je cijelog izraza.
Verzija: 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 */ }U zapisu tag`prefix ${expression} suffix` izraz tag stoji ispred literala omeđenog obrnutim apostrofima. JavaScript poziva funkciju oznake bez prethodnog sastavljanja znakovnog niza. U zapisu tag(`prefix ${expression} suffix`) neoznačeni literal pretvara umetnute vrijednosti u znakovne nizove i spaja ih s tekstom. Funkcija tada prima jedan gotov znakovni niz.
Prvi argument funkcije oznake jest polje strings s tekstualnim dijelovima. JavaScript prije poziva vrednuje izraze ${...} slijeva nadesno i njihove vrijednosti prosljeđuje kao zasebne argumente bez pretvorbe u znakovne nizove. Može ih prikupiti parametar za preostale argumente, kao što je ...values. Za n umetanja postoji n + 1 dijelova, uključujući prazne. Vrijednost cijelog izraza jest ono što funkcija vrati i ne mora biti znakovni niz.
U strings[i] izlazne su sekvence obrađene (cooked), dok strings.raw[i] čuva njihov izvorni zapis. Neispravna izlazna sekvenca u označenom literalu daje undefined kao vrijednost cijelog odgovarajućeg elementa u strings; bez oznake uzrokuje SyntaxError. Oba su polja zamrznuta. Pri ponovnom vrednovanju iste pojave literala u istom ECMAScriptovu okruženju (realm) ponovno se upotrebljava isto polje strings. Druga pojava ima vlastito polje čak i ako je tekst isti.
U zapisu obj.tag`x` poziv prosljeđuje obj kao vrijednost this, kao i pri uobičajenom pozivu metode. Ako se vrijednost oznake ne može pozvati, nastaje TypeError. Izravna upotreba neobaveznog ulančavanja, primjerice obj?.tag`x` , uzrokuje SyntaxError.
To je sintaksa jezika definirana u standardu ECMAScript 2024, a ne API preglednika. Provjeri podršku u ciljnom izvršnom okruženju. Oznaka sama ne pročišćava podatke: nemoj predati nepouzdan rezultat u innerHTML bez odgovarajuće sanitizacije HTML-a.
Primjeri
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` vraća objekt koji `JSON.stringify` pretvara u znakovni niz za ispis. `\n` je jedan znak za novi redak u `strings[0]`, ali dva znaka u `strings.raw[0]`. Vrijednost `7` ostaje broj, a posljednji je dio prazan.
Povezane lekcije
- JavaScript · Lekcija 28 · Napredno · Verzija: 4