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