Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori