String.raw() - JavaScript | MDN Skip to main content Skip to search MDN HTML HTML: Markup language HTML reference Elements Global attributes Attributes See all… HTML guides Responsive images HTML cheatsheet Date & time formats See all… Markup languages SVG MathML XML CSS CSS: Styling language CSS reference Properties Selectors At-rules Values See all… CSS guides Box model Animations Flexbox Colors See all… Layout cookbook Column layouts Centering an element Card component See all… JavaScriptJS JavaScript: Scripting language JS reference Standard built-in objects Expressions & operators Statements & declarations Functions See all… JS guides Control flow & error handing Loops and iteration Working with objects Using classes See all… Web APIs Web APIs: Programming interfaces Web API reference File system API Fetch API Geolocation API HTML DOM API Push API Service worker API See all… Web API guides Using the Web animation API Using the Fetch API Working with the History API Using the Web speech API Using web workers All All web technology Technologies Accessibility HTTP URI Web extensions WebAssembly WebDriver See all… Topics Media Performance Privacy Security Progressive web apps Learn Learn web development Frontend developer course Getting started modules Core modules MDN Curriculum Check out the video course from Scrimba, our partner Learn HTML Structuring content with HTML module Learn CSS CSS styling basics module CSS layout module Learn JavaScript Dynamic scripting with JavaScript module Tools Discover our tools Playground HTTP Observatory Border-image generator Border-radius generator Box-shadow generator Color format converter Color mixer Shape generator About Get to know MDN better About MDN Advertise with us Community MDN on GitHub Blog Toggle sidebar Веб-технологии для разработчиков JavaScript Справочник по JavaScript Стандартные встроенные объекты String String.raw() Theme OS default Light Dark Русский Remember language Learn more Deutsch English (US) Español Français 日本語 한국어 Português (do Brasil) Русский 中文 (简体) 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 г.. Learn more See full compatibility Сводка Статический метод 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. Смотрите также Шаблонные строки String Лексическая грамматика Help improve MDN Was this page helpful to you? Yes No Learn how to contribute This page was last modified on 29 июн. 2026 г. by MDN contributors. View this page on GitHub • Report a problem with this content Filter sidebar Clear filter input Стандартные встроенные объекты String Конструктор String() Статические методы String.fromCharCode() String.fromCodePoint() String.raw() Методы экземпляра String.prototype.anchor() at() String.prototype.big() String.prototype.blink() String.prototype.bold() String.prototype.charAt() String.prototype.charCodeAt() String.prototype.codePointAt() String.prototype.concat() String.prototype.endsWith() String.prototype.fixed() String.prototype.fontcolor() String.prototype.fontsize() String.prototype.includes() String.prototype.indexOf() isWellFormed() String.prototype.italics() String.prototype.lastIndexOf() String.prototype.link() String.prototype.localeCompare() String.prototype.match() String.prototype.matchAll() String.prototype.normalize() String.prototype.padEnd() String.prototype.padStart() String.prototype.repeat() String.prototype.replace() String.prototype.replaceAll() String.prototype.search() String.prototype.slice() String.prototype.small() String.prototype.split() String.prototype.startsWith() String.prototype.strike() String.prototype.sub() String.prototype.substr() String.prototype.substring() String.prototype.sup() String.prototype.toLocaleLowerCase() String.prototype.toLocaleUpperCase() String.prototype.toLowerCase() String.prototype.toString() String.prototype.toUpperCase() toWellFormed() String.prototype.trim() String.prototype.trimRight() String.prototype.trimLeft() String.prototype.valueOf() String.prototype[@@iterator]() Свойства экземпляра String.length Наследование Object/Function Статические методы Function.prototype.apply() Function.prototype.bind() Function.prototype.call() Function.prototype.toString() [Symbol.hasInstance]() Статические свойства Function.displayName Function.length Function.name prototype Function.arguments Function.caller Методы экземпляра Object.prototype.__defineGetter__() Object.prototype.__defineSetter__() Object.prototype.__lookupGetter__() Object.prototype.__lookupSetter__() Object.prototype.hasOwnProperty() Object.prototype.isPrototypeOf() Object.prototype.propertyIsEnumerable() Object.prototype.toLocaleString() Object.prototype.toString() Object.prototype.valueOf() Свойства экземпляра Object.prototype.__proto__ Object.prototype.constructor MDN Your blueprint for a better internet. MDN About Blog Mozilla careers Advertise with us MDN Plus Product help Contribute MDN Community Community resources Writing guidelines MDN Discord MDN on GitHub Developers Web technologies Learn web development Guides Tutorials Glossary Hacks blog Mozilla Website Privacy Notice Telemetry Settings Legal Community Participation Guidelines Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.