WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen