Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Składnia literałów szablonowych z tagiem

Funkcja tagująca otrzymuje fragmenty literału szablonowego i wartości podstawień osobno. Wynikiem całego wyrażenia jest to, co zwróci funkcja.

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

Składnia

tag`prefix ${expression} suffix`
obj.tag`prefix ${expression} suffix`

function tag(strings, ...values) { /* process the parts and return a value */ }

W zapisie tag`prefix ${expression} suffix` wyrażenie tag poprzedza literał ujęty w odwrotne apostrofy. JavaScript wywołuje tag, zamiast najpierw budować napis. Zapis tag(`prefix ${expression} suffix`) jest inny: literał bez tagu zamienia podstawienia na napisy i łączy je z tekstem, a funkcja otrzymuje jeden gotowy napis.

Tag otrzymuje jako pierwszy argument tablicę strings z fragmentami tekstu. Wartości wyrażeń ${...} są obliczane od lewej do prawej przed wywołaniem i przekazywane jako osobne argumenty bez konwersji na napisy. Można je zebrać parametrem ...values. Dla n podstawień tablica ma n + 1 elementów, także wtedy, gdy niektóre fragmenty są puste. Wynik wyrażenia to wartość zwrócona przez tag; nie musi być napisem.

strings[i] zawiera fragment po przetworzeniu sekwencji ucieczki (cooked), a strings.raw[i] zachowuje zapis tych sekwencji (raw). Niepoprawna sekwencja ucieczki w literale z tagiem daje undefined w całym odpowiadającym jej elemencie strings; bez tagu powoduje SyntaxError. Obie tablice są zamrożone. Kolejne wykonania tego samego wystąpienia literału w danym środowisku wykonawczym ECMAScript (realm) używają tej samej tablicy strings. Inne wystąpienie ma własną tablicę, nawet gdy tekst jest identyczny.

W zapisie obj.tag`x` obiekt obj jest przekazywany jako this tak jak przy zwykłym wywołaniu metody. Jeśli wartość tagu nie jest wywoływalna, wystąpi TypeError. Bezpośrednie użycie łańcuchowania opcjonalnego, na przykład obj?.tag`x` , powoduje SyntaxError.

To składnia języka opisana w ECMAScript 2024, a nie interfejs API przeglądarki. Sprawdź obsługę w docelowym środowisku uruchomieniowym. Sam tag nie oczyszcza danych: nie przekazuj niezaufanego wyniku do innerHTML bez odpowiedniej sanityzacji HTML.

Przykłady

function inspect(strings, value) {
  return {
    cookedLength: strings[0].length,
    rawLength: strings.raw[0].length,
    valueType: typeof value,
    tail: strings[1],
  };
}

console.log(JSON.stringify(inspect`\n${7}`));

Wynik

{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}

Tag `inspect` zwraca obiekt, który `JSON.stringify` zamienia na napis do wyświetlenia. `\n` to jeden znak nowego wiersza w `strings[0]`, lecz dwa znaki w `strings.raw[0]`. Wartość `7` pozostaje liczbą, a końcowy fragment jest pusty.

Powiązane lekcje

  • JavaScript · Lekcja 28 · Zaawansowany · Wersja: 4

Źródła