CKTIS / JavaScript
Syntaxis van getagde templateliterals
Een tagfunctie ontvangt de tekstsegmenten en de substitutiewaarden afzonderlijk. De retourwaarde van de tagfunctie is de waarde van de hele expressie.
Versie: 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 */ }In tag`prefix ${expression} suffix` staat de tagexpressie vóór een templateliteral tussen backticks. JavaScript roept de tag aan zonder eerst een tekenreeks te maken. Bij tag(`prefix ${expression} suffix`) zet de ongetagde literal de substitutiewaarden juist om in tekenreeksen en voegt die samen met de tekst. De functie ontvangt dan één kant-en-klare tekenreeks.
Het eerste argument van de tag is de array strings met letterlijke tekstsegmenten. JavaScript evalueert de ${...}-expressies vóór de aanroep, van links naar rechts, en geeft de waarden door als afzonderlijke argumenten zonder ze om te zetten naar tekenreeksen. Een restparameter zoals ...values verzamelt ze. Bij n substituties zijn er n + 1 segmenten, ook als een of meer segmenten leeg zijn. De expressie levert op wat de tag retourneert; dat hoeft geen tekenreeks te zijn.
In strings[i] zijn escapereeksen verwerkt (cooked); strings.raw[i] behoudt hun oorspronkelijke schrijfwijze. Een ongeldige escapereeks maakt het volledige bijbehorende element van strings in een getagde literal undefined; zonder tag ontstaat een SyntaxError. Beide arrays zijn bevroren. Bij herhaalde evaluatie van hetzelfde voorkomen van de literal binnen dezelfde ECMAScript-realm wordt dezelfde strings-array hergebruikt. Een ander voorkomen krijgt een eigen array, zelfs als de tekst identiek is.
In obj.tag`x` geeft de aanroep obj door als this, net als bij een gewone methodeaanroep. Als de tagwaarde niet aanroepbaar is, ontstaat een TypeError. Rechtstreeks gebruik van optional chaining, zoals in obj?.tag`x` , veroorzaakt een SyntaxError.
Dit is taalsyntaxis uit ECMAScript 2024, geen browser-API. Controleer de ondersteuning in je doelomgeving. Een tag schoont gegevens niet automatisch op: geef onbetrouwbare uitvoer niet door aan innerHTML zonder geschikte HTML-opschoning.
Voorbeelden
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}`));Resultaat
{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}`inspect` retourneert een object dat `JSON.stringify` omzet in een tekenreeks voor de uitvoer. `\n` is één regeleindeteken in `strings[0]`, maar twee tekens in `strings.raw[0]`. De waarde `7` blijft een getal en het laatste segment is leeg.
Gerelateerde lessen
- JavaScript · Les 28 · Gevorderd · Versie: 4