Name

escape() — encode a string

Availability

deprecated

Synopsis

escape(s)

Arguments

s

The string that is to be “escaped” or encoded.

Returns

An encoded copy of s in which certain characters have been replaced by hexadecimal escape sequences.

Description

escape() is a global function. It returns a new string that contains an encoded version of s. The string s itself is not modified.

escape() returns a string in which all characters of s other than ASCII letters, digits, and the punctuation characters @, *, _, +, -, ., and / have been replaced by escape sequences of the form % xx or %u xxxx (where x represents a hexadecimal digit). Unicode characters \u0000 to \u00ff are replaced with the % xx escape sequence, and all other Unicode characters are replaced with the %u xxxx sequence.

Use the unescape() function to decode a string encoded with escape().

Although the escape() function was standardized in the first version of ECMAScript, it was deprecated and removed from the standard by ECMAScript v3. Implementations of ECMAScript are likely to implement this function, but they are not required to. You should use encodeURI() and encodeURIComponent() instead of escape().

Example

escape("Hello World!");  // Returns "Hello%20World%21"

Get JavaScript: The Definitive Guide, 6th Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.