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.