CKTIS / JavaScript
String.raw — nezpracované části šablonových literálů
String.raw je statická metoda používaná jako značka šablonového literálu. Zachovává zápis sekvencí, jako je \n, v doslovných textových částech, ale výrazy ${...} stále vyhodnocuje a vkládá jejich hodnoty.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
String.raw`text${expression}text`
String.raw(template, ...substitutions)String.raw je statická metoda, nikoli metoda jednotlivého řetězce. Jako značka šablonového literálu spojuje jeho nezpracované doslovné textové části se substitucemi. Sekvence \n v doslovné části vytvoří zpětné lomítko a písmeno n, nikoli znak nového řádku.
Výrazy uvnitř ${...} se stále vyhodnocují a jejich hodnoty se převádějí na řetězce. Nezpracované zacházení se týká doslovných částí, nikoli substitucí: pokud substituovaná hodnota už obsahuje znak nového řádku, zůstane jím. Metoda nevrací zpět dřívější zpracování escape sekvencí a neposkytuje bezpečné kódování pro HTML ani SQL.
Možné je také běžné volání String.raw(template, ...substitutions). Metoda čte template.raw jako objekt podobný poli a prokládá jeho prvky substitucemi. Chybějící substituce nic nepřidají, nadbytečné se ignorují a raw o nulové délce vytvoří prázdný řetězec. Chybějící raw nebo hodnota null způsobí TypeError.
V příkladu obsahuje první řádek doslovné \n, druhý potvrzuje obsah řetězce a třetí ukazuje vynechanou substituci mezi B a C.
Příklady
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));Výsledek
Hello\nAda! true A7BC
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.