CKTIS / JavaScript
String.raw — sirovi segmenti predložaka literala
String.raw je statička metoda koja se upotrebljava kao oznaka predloška literala. Čuva zapis nizova poput \n u doslovnim tekstualnim segmentima, ali i dalje procjenjuje izraze ${...} i umeće njihove vrijednosti.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
String.raw`text${expression}text`
String.raw(template, ...substitutions)String.raw je statička metoda, a ne metoda pojedinačnog niza znakova. Kao oznaka predloška literala spaja njegove sirove doslovne tekstualne segmente sa zamjenama. Niz \n u doslovnom segmentu daje obrnutu kosu crtu i slovo n, a ne znak novog retka.
Izrazi unutar ${...} i dalje se procjenjuju, a njihove se vrijednosti pretvaraju u nizove znakova. Sirova obrada odnosi se na doslovne segmente, a ne na zamjene: ako zamijenjena vrijednost već sadrži znak novog retka, taj znak ostaje znak novog retka. Metoda ne poništava raniju obradu izlaznih nizova i ne pruža sigurno kodiranje za HTML ili SQL.
Moguć je i običan poziv String.raw(template, ...substitutions). Metoda čita template.raw kao objekt nalik nizu i isprepliće njegove elemente sa zamjenama. Zamjene koje nedostaju ne dodaju ništa, dodatne se zanemaruju, a raw duljine nula daje prazan niz znakova. Ako raw nedostaje ili ima vrijednost null, dolazi do pogreške TypeError.
U primjeru prvi redak sadrži doslovni \n, drugi potvrđuje sadržaj niza znakova, a treći prikazuje izostavljenu zamjenu između B i C.
Primjeri
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));Rezultat
Hello\nAda! true A7BC
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.