← 返回首页
String.raw() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Веб-технологии для разработчиков
  2. JavaScript
  3. Справочник по JavaScript
  4. Стандартные встроенные объекты
  5. String
  6. String.raw()
Theme
  • OS default
  • Light
  • Dark
Русский
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

String.raw()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since сентябрь 2015 г..

Сводка

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

In this article

Синтаксис

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

Параметры

callSite

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

...substitutions

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

templateString

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

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

TypeError

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

Описание

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

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

Примеры

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

js
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т'

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

Specification
ECMAScript® 2027 Language Specification
# sec-string.raw

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

Enable JavaScript to view this browser compatibility table.

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

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 17 дек. 2024 г. by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Стандартные встроенные объекты
  2. String
  3. Конструктор
    1. String()
  4. Статические методы
    1. String.fromCharCode()
    2. String.fromCodePoint()
    3. String.raw()
  5. Методы экземпляра
    1. String.prototype.anchor()
    2. at()
    3. String.prototype.big()
    4. String.prototype.blink()
    5. String.prototype.bold()
    6. String.prototype.charAt()
    7. String.prototype.charCodeAt()
    8. String.prototype.codePointAt()
    9. String.prototype.concat()
    10. String.prototype.endsWith()
    11. String.prototype.fixed()
    12. String.prototype.fontcolor()
    13. String.prototype.fontsize()
    14. String.prototype.includes()
    15. String.prototype.indexOf()
    16. isWellFormed()
    17. String.prototype.italics()
    18. String.prototype.lastIndexOf()
    19. String.prototype.link()
    20. String.prototype.localeCompare()
    21. String.prototype.match()
    22. String.prototype.matchAll()
    23. String.prototype.normalize()
    24. String.prototype.padEnd()
    25. String.prototype.padStart()
    26. String.prototype.repeat()
    27. String.prototype.replace()
    28. String.prototype.replaceAll()
    29. String.prototype.search()
    30. String.prototype.slice()
    31. String.prototype.small()
    32. String.prototype.split()
    33. String.prototype.startsWith()
    34. String.prototype.strike()
    35. String.prototype.sub()
    36. String.prototype.substr()
    37. String.prototype.substring()
    38. String.prototype.sup()
    39. String.prototype.toLocaleLowerCase()
    40. String.prototype.toLocaleUpperCase()
    41. String.prototype.toLowerCase()
    42. String.prototype.toString()
    43. String.prototype.toUpperCase()
    44. toWellFormed()
    45. String.prototype.trim()
    46. String.prototype.trimRight()
    47. String.prototype.trimLeft()
    48. String.prototype.valueOf()
    49. String.prototype[@@iterator]()
  6. Свойства экземпляра
    1. String.length
  7. Наследование
  8. Object/Function
  9. Статические методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  10. Статические свойства
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  11. Методы экземпляра
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  12. Свойства экземпляра
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.