CKTIS / JavaScript
String.raw — rohe Segmente von Template-Literalen
String.raw ist eine statische Methode, die als Tag eines Template-Literals verwendet wird. Sie bewahrt die Schreibweise von Sequenzen wie \n in literalen Textsegmenten, wertet aber weiterhin ${...}-Ausdrücke aus und fügt deren Werte ein.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
String.raw`text${expression}text`
String.raw(template, ...substitutions)String.raw ist eine statische Methode und keine Methode einer einzelnen Zeichenkette. Als Tag eines Template-Literals verbindet sie dessen rohe literale Textsegmente mit den Ersetzungen. Eine Sequenz \n in einem literalen Segment ergibt einen Backslash und den Buchstaben n, nicht ein Zeilenumbruchzeichen.
Ausdrücke innerhalb von ${...} werden weiterhin ausgewertet und ihre Werte in Zeichenketten umgewandelt. Die rohe Verarbeitung betrifft literale Segmente, nicht Ersetzungen: Enthält ein eingesetzter Wert bereits ein Zeilenumbruchzeichen, bleibt es ein Zeilenumbruch. Die Methode macht eine vorherige Verarbeitung von Escape-Sequenzen nicht rückgängig und bietet keine sichere Kodierung für HTML oder SQL.
Auch ein gewöhnlicher Aufruf, String.raw(template, ...substitutions), ist möglich. Die Methode liest template.raw als array-ähnliches Objekt und verschränkt dessen Elemente mit den Ersetzungen. Fehlende Ersetzungen fügen nichts hinzu, zusätzliche Ersetzungen werden ignoriert, und ein raw mit Länge null ergibt eine leere Zeichenkette. Ein fehlendes raw oder ein Wert null verursacht einen TypeError.
Im Beispiel enthält die erste Zeile ein wörtliches \n, die zweite bestätigt den Inhalt der Zeichenkette und die dritte zeigt die ausgelassene Ersetzung zwischen B und C.
Beispiele
const name = "Ada";
const text = String.raw`Hello\n${name}!`;
console.log(text);
console.log(text === "Hello\\nAda!");
console.log(String.raw({ raw: ["A", "B", "C"] }, 7));Ergebnis
Hello\nAda! true A7BC
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.