JavaScript метод raw()ECMAScript 2015

JavaScript String

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

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

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

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
raw()ECMAScript 201541.034.028.010.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