Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Literały szablonowe w JavaScript

Twórz wielowierszowe napisy i wstawiaj wyniki wyrażeń. Dowiedz się, kiedy powstaje napis, a kiedy fragmenty i wartości trafiają do funkcji tagującej.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

`text`
`text ${expression} more text`
tag`text ${expression} more text`
String.raw`text ${expression} more text`

Literał szablonowy zapisuje się między znakami akcentu grawisowego (backtickami), a nie między cudzysłowami. Wstawki ${expression} zawierają wyrażenia. W literałach bez tagu JavaScript oblicza je od lewej do prawej, zamienia każdy wynik na napis i łączy go z tekstem. Bezpośrednia wstawka z wartością typu Symbol powoduje TypeError. Podziały wierszy i wcięcia w tekście literału stają się częścią napisu. Użyj \`, aby wstawić backtick, oraz \${, aby zapisać ${ bez rozpoczynania wstawki.

Umieszczenie funkcji bezpośrednio przed otwierającym backtickiem wywołuje ją jako tag. Pierwszy argument to zamrożona tablica przetworzonych fragmentów tekstu, również pustych; kolejne argumenty to wartości wyrażeń bez automatycznej konwersji na napisy. Wynikiem całego wyrażenia jest to, co zwróci tag — nie musi to być napis. Wielokrotne wykonanie tego samego wystąpienia literału w tym samym środowisku globalnym (realm) przekazuje tę samą tablicę, nie nową kopię.

W przetworzonym fragmencie \n oznacza znak nowego wiersza. Zamrożona tablica parts.raw zachowuje w tym miejscu ukośnik odwrotny i literę n. Niepoprawna sekwencja ucieczki, np. \xZ, powoduje SyntaxError bez tagu; z tagiem odpowiadający jej fragment przetworzonej tablicy ma wartość undefined, a surowy zapis pozostaje dostępny. Wbudowany tag String.raw łączy surowe fragmenty z wartościami wstawek przekonwertowanymi na napisy.

Interpolacja nie zabezpiecza danych na potrzeby HTML, a sam tag nie gwarantuje bezpieczeństwa. Aby wyświetlić niezaufane dane jako zwykły tekst w elemencie przeznaczonym do wyświetlania tekstu, takim jak <p> lub <span>, użyj textContent, nie innerHTML. W elemencie <script> właściwość textContent ustawia treść źródłową skryptu, a nie tekst do wyświetlenia. Literały szablonowe należą do ECMAScript i nie wymagają DOM; obsługę sprawdź w docelowym środowisku uruchomieniowym.

Przykłady

{
  const count = 5;
  const report = `Items: ${count}
Status: ready`;

  function inspect(parts, value) {
    return [parts[0], parts.raw[0], value];
  }

  console.log(JSON.stringify(report));
  console.log(JSON.stringify(inspect`Items:\n${count}`));
}

Wynik

"Items: 5\nStatus: ready"
["Items:\n","Items:\\n",5]

Pierwszy wiersz pokazuje wielowierszowy napis. Drugi porównuje fragment przetworzony i surowy. `JSON.stringify` uwidacznia różnicę między znakiem nowego wiersza a dosłownym zapisem `\n`; liczba `5` pozostaje bez cudzysłowu.

Powiązane lekcje

  • JavaScript · Lekcja 1 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 4 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 5 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 6 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 7 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 8 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 10 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 11 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 14 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 16 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 17 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 18 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 17 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 19 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 20 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 21 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 22 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 23 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 25 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 28 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 30 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 31 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 33 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 35 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 38 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 42 · Średniozaawansowany · Wersja: 3

Źródła