Spec-Zone.ru › JavaScript

escape()

Базовый уровень Ограниченная доступность

Эта функция не является Базовой, поскольку она не работает в некоторых из наиболее широко используемых браузеров.

Устаревший: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут по-прежнему ее поддерживать, она, возможно, уже была удалена из соответствующих веб-стандартов, находится в процессе удаления или сохраняется только в целях совместимости. Избегайте ее использования и обновите существующий код, если это возможно; см. таблицу совместимости в нижней части этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

Примечание: escape() является нестандартной функцией, реализованной браузерами и стандартизированной только для обеспечения кросс-движковой совместимости. Не требуется, чтобы она была реализована всеми движками JavaScript, и она может работать не везде. Используйте encodeURIComponent() или encodeURI(), если возможно.

Функция escape() вычисляет новую строку, в которой определенные символы были заменены шестнадцатеричными escape-последовательностями.

Синтаксис

escape(str)

Параметры

str
Строка для кодирования.

Возвращаемое значение

Новая строка, в которой определенные символы были экранированы.

Описание

escape() является свойством-функцией глобального объекта.

Функция escape() заменяет все символы escape-последовательностями, за исключением ASCII словесных символов (A–Z, a–z, 0–9, _) и @\*_+-./. Символы экранируются кодовыми единицами UTF-16. Если значение кодовой единицы меньше 256, оно представляется двухзначным шестнадцатеричным числом в формате %XX, дополненным нулями слева при необходимости. В противном случае оно представляется четырехзначным шестнадцатеричным числом в формате %uXXXX, дополненным нулями слева при необходимости.

Примечание: Эта функция в основном использовалась для процентного кодирования и частично основана на формате экранирования в RFC 1738. Формат экранирования не является escape-последовательностью в строковых литералах. Вы можете заменить %XX на \xXX и %uXXXX на \uXXXX, чтобы получить строку, содержащую фактические escape-последовательности строкового литерала.

Примеры

Использование escape()

escape("abc123"); // "abc123"
escape("äöü"); // "%E4%F6%FC"
escape("ć"); // "%u0107"

// special characters
escape("@*_+-./"); // "@*_+-./"

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

Спецификация
Спецификация языка ECMAScript® 2027
# sec-escape-string

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

Десктопные Мобильные Серверные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
escape
1
12
1
3
1
18
4
10.1
1
1.0
4.4
1
1.0.0
1.0
0.10.0

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

  • Полифилл escape в core-js
  • encodeURI
  • encodeURIComponent
  • unescape

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/escape

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API