JavaScript метод raw()

Определение и применение

JavaScript метод raw() возвращает необработанную строковую форму строки шаблона.

Поддержка браузерами

Метод	Chrome	Firefox	Opera	Safari	IExplorer	Edge
`raw()`	41.0	34.0	28.0	10.0	Нет	Да

JavaScript синтаксис:

String.raw`templateString`;
String.raw( obj, ...substitutions );

Версия JavaScript

ECMAScript 2015 (6th Edition, ECMA-262)

Значения параметров

Параметр	Описание
templateString	Шаблонная строка. Допускается использование выражений внутри строки ${выражение}. Обязательный параметр.
obj	Правильно отформатированный объект, указанный с использованием нотации литерала объекта. Например: {raw: "value"}. Обязательный параметр.
substitutions	Значение, или значения для подстановки.Необязательный параметр.

Исключения

Тип исключения	Описание
TypeError	Возникает в том случае, если значение параметра, определяющее отформатированный объект не является правильно сформированным объектом.

Пример использования

// инициализируем две переменные, содержащие шаблонные строки
var temString = String.raw`Hello\nworld!`,
    temString2 = String.raw`Hello\u0040!`;

// символ после 'Hello' не является символом новой строки
console.log( temString ); // "Hello\nworld!" 

// обратные слеши будут присутствовать в выходной строке
console.log( temString2 ); // "Hello\u0040!"

// вы можете использовать HTML внутри шаблонной строки
var myTemplate = `
  <pre>
    Отформатированный 
    многострочный текст
    {
      prop: "value"
    }
  </pre>`

// вы можете использовать выражения внутри шаблонной строки
var temString = String.raw`Hello\n${2+2*2}!`;
console.log( temString ); // "Hello\n6!"

// допускается использовать синтаксис метода .raw() как функции
String.raw({ raw: "Hello" }, 1, 2, 3);  // "H1e2l3lo"
String.raw({ raw: "ALLOHA" }, "world"); // "AworldLLOHA"

JavaScript String