CKTIS / JavaScript
Syntax von Template-Literalen
Template-Literale erlauben mehrzeiligen Text und das Einsetzen von Ausdrücken. Bei einem getaggten Template erhält eine Funktion Textabschnitte und eingesetzte Werte getrennt.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
`text`
`first line
second line`
`text ${expression} more text`
tag`text ${expression} more text`Template-Literale stehen zwischen Backticks statt zwischen einfachen oder doppelten Anführungszeichen. Normale Zeilenumbrüche und Einrückungen im Text werden Teil des Ergebnisses. Für einen wörtlichen Backtick setze einen Backslash davor. Mit \${ schreibst du ${, ohne eine Ersetzung einzuleiten.
In einem Literal ohne Tag wertet JavaScript die Ausdrücke in ${expression} von links nach rechts aus und wandelt jeden Wert vor dem nächsten Ausdruck in eine Zeichenkette um. Das Ergebnis ist eine Zeichenkette. Das direkte Einsetzen eines Symbol-Werts löst einen TypeError aus; für seine Textdarstellung verwende ausdrücklich String(value).
Bei einem getaggten Template ruft tag`...` eine Funktion ohne Klammern auf. Ihr erstes Argument, parts, ist ein eingefrorenes Array der verarbeiteten Textabschnitte, einschließlich leerer Abschnitte: n Ersetzungen ergeben n + 1 Abschnitte. Die übrigen Argumente sind die eingesetzten Werte ohne automatische Umwandlung in Zeichenketten. Der Rückgabewert des Tags ist das Ergebnis des Ausdrucks. Bei wiederholter Auswertung derselben Quelltextstelle im selben JavaScript-Realm wird dasselbe Array verwendet.
Im eingefrorenen Array parts.raw stehen die Abschnitte ohne Auswertung der Escape-Sequenzen. CRLF- und CR-Zeilenenden im Quelltext werden in beiden Varianten zu LF. Eine ungültige Escape-Sequenz wie \xG führt ohne Tag zu einem SyntaxError; mit Tag ist der betroffene verarbeitete Abschnitt undefined, während der rohe Abschnitt die Sequenz enthält.
Das ist JavaScript-Syntax, keine DOM-API. Prüfe die Unterstützung in deiner Zielumgebung. Interpolation maskiert Werte nicht für HTML. Um nicht vertrauenswürdigen Text in einem gewöhnlichen Seitenelement anzuzeigen, verwende textContent statt innerHTML.
Beispiele
const count = 2;
const message = `Total: ${count + 1}
Ready`;
function inspect(parts, value) {
return [parts[1].startsWith("\n"), parts.raw[1].startsWith("\\n"), typeof value];
}
console.log(message);
console.log(JSON.stringify(inspect`Total: ${count + 1}\nReady`));Ergebnis
Total: 3 Ready [true,true,"number"]
Das Literal ohne Tag gibt zwei Zeilen aus. Im Ergebnis des Tags bedeutet das erste `true`, dass der verarbeitete Abschnitt mit einem Zeilenumbruch beginnt. Das zweite zeigt, dass der rohe Abschnitt mit zwei Zeichen beginnt: einem Backslash und `n`. `"number"` bestätigt, dass der Tag eine Zahl erhalten hat.
Zugehörige Lektionen
- JavaScript · Lektion 23 · Fortgeschritten · Version: 4
- JavaScript · Lektion 24 · Fortgeschritten · Version: 4
- JavaScript · Lektion 25 · Fortgeschritten · Version: 4
- JavaScript · Lektion 31 · Fortgeschritten · Version: 4
- JavaScript · Lektion 32 · Fortgeschritten · Version: 4
- JavaScript · Lektion 35 · Fortgeschritten · Version: 4
- JavaScript · Lektion 40 · Fortgeschritten · Version: 4
- JavaScript · Lektion 41 · Fortgeschritten · Version: 4
- JavaScript · Lektion 42 · Fortgeschritten · Version: 4
- JavaScript · Lektion 43 · Fortgeschritten · Version: 4