CKTIS / JavaScript
String.raw — nespracované časti šablónových literálov
String.raw je statická metóda používaná ako značka šablónového literálu. Zachováva zápis sekvencií, ako je \n, v doslovných textových častiach, no výrazy ${...} stále vyhodnocuje a vkladá ich hodnoty.
Verzia: 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 je statická metóda, nie metóda jednotlivého reťazca. Ako značka šablónového literálu spája jeho nespracované doslovné textové časti so substitúciami. Sekvencia \n v doslovnej časti vytvorí spätnú lomku a písmeno n, nie znak nového riadka.
Výrazy vnútri ${...} sa stále vyhodnocujú a ich hodnoty sa konvertujú na reťazce. Nespracované spracovanie sa týka doslovných častí, nie substitúcií: ak substituovaná hodnota už obsahuje znak nového riadka, zostane ním. Metóda nevracia späť skoršie spracovanie escape sekvencií a neposkytuje bezpečné kódovanie pre HTML ani SQL.
Možné je aj bežné volanie String.raw(template, ...substitutions). Metóda číta template.raw ako objekt podobný poľu a medzi jeho prvky vkladá substitúcie. Chýbajúce substitúcie nič nepridajú, nadbytočné sa ignorujú a raw s nulovou dĺžkou vytvorí prázdny reťazec. Chýbajúce raw alebo hodnota null spôsobí TypeError.
V príklade obsahuje prvý riadok doslovné \n, druhý potvrdzuje obsah reťazca a tretí ukazuje vynechanú substitúciu medzi B a C.
Prí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ýsledok
Hello\nAda! true A7BC
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.