KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen