CKTIS / JavaScript
String.raw — neobdelani deli predlogovnih nizov
String.raw je statična metoda, ki se uporablja kot oznaka predlogovnega niza. Ohrani zapis zaporedij, kot je \n, v dobesednih besedilnih delih, vendar še vedno ovrednoti izraze ${...} in vstavi njihove vrednosti.
Različica: 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čna metoda, ne metoda posameznega niza. Kot oznaka predlogovnega niza združi njegove neobdelane dobesedne besedilne dele z zamenjavami. Zaporedje \n v dobesednem delu ustvari obrnjeno poševnico in črko n, ne pa znaka za novo vrstico.
Izrazi znotraj ${...} se še vedno ovrednotijo, njihove vrednosti pa se pretvorijo v nize. Neobdelana obravnava velja za dobesedne dele, ne za zamenjave: če vstavljena vrednost že vsebuje znak za novo vrstico, ta ostane znak za novo vrstico. Metoda ne razveljavi predhodne obdelave ubežnih zaporedij in ne zagotavlja varnega kodiranja za HTML ali SQL.
Mogoč je tudi običajen klic String.raw(template, ...substitutions). Metoda prebere template.raw kot objekt, podoben polju, in njegove elemente prepleta z zamenjavami. Manjkajoče zamenjave ne dodajo ničesar, odvečne se prezrejo, raw z dolžino nič pa ustvari prazen niz. Če raw manjka ali ima vrednost null, pride do napake TypeError.
V primeru prva vrstica vsebuje dobesedni \n, druga potrdi vsebino niza, tretja pa pokaže izpuščeno zamenjavo med B in C.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.