Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Literał szablonowy

Literał szablonowy (template literal) używa znaków ` jako ograniczników. Pozwala osadzać wyrażenia przez ${expression} i zapisywać tekst wielowierszowy. Wariant z funkcją tagującą przekazuje jej fragmenty tekstu oraz wartości wyrażeń.

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

`text ${expression} text`
tag`text ${expression} text`

Literał szablonowy (template literal) jest ograniczony znakami grawisu, a nie apostrofami lub cudzysłowami. W zwykłym wariancie tworzy ciąg znaków. Składnia ${expression} oblicza wyrażenie, przekształca jego wynik na tekst i wstawia go w danym miejscu; podstawienia są przetwarzane od lewej do prawej.

W zwykłym wariancie wcięcia oraz podziały wierszy, które nie są częścią kontynuacji wiersza, trafiają do wynikowego ciągu znaków. Odwrotny ukośnik bezpośrednio przed końcem wiersza w kodzie źródłowym tworzy kontynuację wiersza i nie wprowadza znaku nowego wiersza do wyniku. Sekwencje ucieczki, takie jak \n, są interpretowane. Aby zapisać dosłowne ${, użyj \${; znak grawisu poprzedź odwrotnym ukośnikiem. W zwykłych ciągach ograniczonych przez ' lub " zapis ${expression} nie wykonuje interpolacji.

Wariant tag bezpośrednio przed literałem wywołuje funkcję tagującą: otrzymuje ona tablicę przetworzonych fragmentów tekstu, a następnie wartości podstawień bez automatycznej zamiany na tekst. Właściwość raw tej tablicy udostępnia nieprzetworzone fragmenty. Wynikiem jest wartość zwrócona przez funkcję, niekoniecznie ciąg znaków.

Przykład łączy interpolację, obliczenie i podział wiersza. Sam literał nie zapewnia automatycznego kodowania HTML ani bezpiecznego budowania zapytań SQL; odpowiednie przetwarzanie trzeba zapewnić osobno.

Przykłady

const name = "Ada";
const count = 3;
const message = `Hello, ${name}!
Total: ${count * 2}`;
console.log(message);

Wynik

Hello, Ada!
Total: 6

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

Źródła