CKTIS / JavaScript
Syntax von getaggten Template-Literalen
Eine Tag-Funktion erhält die Textabschnitte eines Template-Literals und die Werte der Platzhalter getrennt. Ihr Rückgabewert ist der Wert des gesamten Ausdrucks.
Version: 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` steht der Tag-Ausdruck vor einem Template-Literal in Backticks. JavaScript ruft den Tag auf, statt zuerst eine Zeichenkette zu bilden. Anders bei tag(`prefix ${expression} suffix`): Das Literal ohne Tag wandelt die eingesetzten Werte in Zeichenketten um und fügt sie mit dem Text zusammen. Die Funktion erhält eine einzige fertige Zeichenkette.
Das erste Argument des Tags ist das Array strings mit den Textabschnitten. JavaScript wertet die ${...}-Ausdrücke vor dem Aufruf von links nach rechts aus und übergibt ihre Werte als einzelne Argumente, ohne sie in Zeichenketten umzuwandeln. Ein Restparameter wie ...values sammelt sie. Bei n Platzhaltern gibt es n + 1 Abschnitte, einschließlich leerer Abschnitte. Der Ausdruck ergibt den Rückgabewert des Tags, der keine Zeichenkette sein muss.
In strings[i] sind die Escape-Sequenzen ausgewertet (cooked); strings.raw[i] behält ihre Schreibweise bei. Eine ungültige Escape-Sequenz in einem getaggten Literal setzt das gesamte entsprechende Element in strings auf undefined; ohne Tag entsteht ein SyntaxError. Beide Arrays sind eingefroren. Bei wiederholter Auswertung desselben Literalvorkommens im selben ECMAScript-Realm wird dasselbe strings-Array verwendet. Ein anderes Vorkommen hat auch bei identischem Text sein eigenes Array.
In obj.tag`x` wird obj wie bei einem gewöhnlichen Methodenaufruf als this übergeben. Ist der Tag-Wert nicht aufrufbar, entsteht ein TypeError. Die direkte Kombination mit optionaler Verkettung, etwa obj?.tag`x` , ist ein SyntaxError.
Dies ist in ECMAScript 2024 definierte Sprachsyntax, keine Browser-API. Prüfe die Unterstützung in deiner Zielumgebung. Ein Tag bereinigt Daten nicht automatisch: Übergib keine nicht vertrauenswürdigen Ergebnisse ohne geeignete HTML-Bereinigung an innerHTML.
Beispiele
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}`));Ergebnis
{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}`inspect` gibt ein Objekt zurück, das `JSON.stringify` für die Ausgabe in eine Zeichenkette umwandelt. `\n` ist in `strings[0]` ein Zeilenumbruchzeichen, in `strings.raw[0]` aber zwei Zeichen. `7` bleibt eine Zahl und der letzte Abschnitt ist leer.
Zugehörige Lektionen
- JavaScript · Lektion 28 · Fortgeschritten · Version: 4