Сводка

Статический методString.raw() является теговой функцией дляшаблонных строк; подобно префиксуr в Python или префиксу@ в C# для строковых литералов, эта функция используется для получения необработанной строки из шаблона.

Синтаксис

String.raw(callSite, ...substitutions)String.raw`templateString`

Параметры

callSite

Правильно сформированный объект вызова, например{ raw: 'string' }.

...substitutions

Значения подстановок.

templateString

Шаблонная строка, возможно с подстановками (${...}).

Выбрасываемые исключения

TypeError

Если первый аргумент не является правильно сформированным объектом вызова, выбрасывается исключениеTypeError.

Описание

В большинстве случаев методString.raw() используется вместе с шаблонными строками. Первый синтаксис, показанный выше, используется редко, поскольку движок JavaScript будет вызывать метод с соответствующими аргументами, подобно другимтеговым функциям.

МетодString.raw() является единственной встроенной теговой функцией шаблонных строк, выступающей стандартной функцией по объединению их фрагментов. Вы и сами могли бы реализовать подобную функциональность на JavaScript.

Примеры

Пример: использование методаString.raw()

String.raw`Привет\n${2 + 3}!`;// 'Привет\n5!', символ после 'Привет' не является символом новой строки,// '\' и 'n' - это два символа.String.raw`Привет\u000A!`;// 'Привет\u000A!', а здесь мы получим символы//  \, u, 0, 0, 0, A, всего 6 символов.// Экранирующие символы не имеют особого значения и// обратные слеши будут присутствовать в выходной строке.// Вы можете убедиться в этом, проверив свойство .length строки.let name = "Боб";String.raw`Привет\n${name}!`;// 'Привет\nБоб!', сработала подстановка.// Обычно вам не нужно вызывать метод String.raw() как функцию,// но никто не запрещает вам делать это:String.raw({ raw: "тест" }, 0, 1, 2);// 'т0е1с2т'

Спецификации

Совместимость с браузерами

Смотрите также

• Шаблонные строки
• String
• Лексическая грамматика