Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.raw — surowe fragmenty literału szablonowego

String.raw to statyczna metoda używana jako tag literału szablonowego. Zachowuje zapis sekwencji takich jak \n w jego fragmentach tekstowych, ale nadal oblicza wyrażenia ${...} i wstawia ich wartości.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

String.raw`text${expression}text`
String.raw(template, ...substitutions)

String.raw jest metodą statyczną, nie metodą pojedynczego napisu. Jako tag literału szablonowego łączy jego surowe fragmenty tekstowe z podstawieniami. Zapis \n we fragmencie daje ukośnik odwrotny i literę n, a nie znak nowego wiersza.

Wyrażenia ${...} nadal są obliczane, a ich wartości konwertowane na napisy. Surowość dotyczy fragmentów literału, nie podstawień: jeśli podstawiana wartość zawiera już znak nowego wiersza, pozostaje on znakiem nowego wiersza. Metoda nie cofa wcześniejszego przetwarzania sekwencji specjalnych i nie zapewnia bezpiecznego kodowania dla HTML ani SQL.

Możliwe jest też zwykłe wywołanie String.raw(template, ...substitutions). Metoda odczytuje template.raw jako obiekt tablicopodobny i przeplata jego elementy podstawieniami. Brakujące podstawienia niczego nie dodają, nadmiarowe są ignorowane, a zerowa długość raw daje pusty napis. Brak raw lub jego wartość null powoduje TypeError.

W przykładzie pierwsza linia zawiera dosłowne \n, druga potwierdza zawartość napisu, a trzecia pokazuje pominięcie brakującego podstawienia między B i C.

Przykłady

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));

Wynik

Hello\nAda!
true
A7BC

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła