escape()

Attention ! Bien que escape(…) ne soit pas strictement obsolète (au sens où elle n'a pas été retirée des standards), elle est définie au sein de l'Annexe B du standard ECMA-262 qui commence par :
… L'ensemble des fonctionnalités et comportements définis dans cette annexe possède une ou plusieurs caractéristiques indésirables. En l'absence d'une utilisation historique, ces fonctionnalités seraient retirés de la spécification. …
… Les développeurs ne devraient pas utiliser ces fonctionnalités et comportements ou présupposer qu'elles existent lors de l'écriture de nouveau code ECMAScript. …

La fonction escape() permet de renvoyer une nouvelle chaîne de caractères dont certains caractères ont été remplacés par leur séquence d'échappement hexadécimale. Cette méthode est obsolète et il est donc conseillé d'utiliser encodeURI ou encodeURIComponent à la place.

Note : Cette fonction pouvait être utilisée pour l'encodage de fragment de requêtes d'URL. Si on souhaite remplacer des caractères par leur séquence d'échappement correcte (avec %20 par exemple), on pourra utiliser decodeURIComponent.

Syntaxe

escape(str)

Paramètres

str
Une chaîne de caractères à encoder.

Valeur de retour

Une nouvelle chaîne de caractères dont certains caractères ont été échappés.

Description

La fonction escape est une propriété de l'objet global. Les caractères spéciaux, sauf @*_+-./, seront encodés.

La forme hexadécimale des caractères dont la valeur du codet est inférieure à 0xFF sera représentée sur deux chiffres : %xx. Pour les caractères avec un code supérieur, quatre chiffres seront utilisés avec le format suivant %uxxxx.

Exemples

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

// caractères spéciaux
escape("@*_+-./");    // "@*_+-./"

Spécifications

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale.
ECMAScript 5.1 (ECMA-262)
La définition de 'escape' dans cette spécification.		 Standard Définie dans l'annexe B (informative) sur la compatibilité.
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'escape' dans cette spécification.		 Standard Définie dans l'annexe B (normative) pour les fonctionnalités additionnelles d'ECMAScript pour les navigateurs Web.
ECMAScript Latest Draft (ECMA-262)
La définition de 'escape' dans cette spécification.		 Projet Définie dans l'annexe B (normative) pour les fonctionnalités additionnelles d'ECMAScript pour les navigateurs Web.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
escape
Obsolète
Chrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 3Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui

Légende

Support complet  
Support complet
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.

Voir aussi

Sujets associés
  1. JavaScript
  2. Tutoriel :
  3. Débutant
    1. Les bases en JavaScript
    2. Premiers pas en JavaScript
    3. Les briques JavaScript
    4. Introducing JavaScript objects
  4. Guide JavaScript
    1. Introduction
    2. Types et grammaire
    3. Contrôle du flux et gestion des erreurs
    4. Boucles et itération
    5. Fonctions
    6. Expressions et opérateurs
    7. Nombres et dates
    8. Formatage du texte
    9. Expressions rationnelles
    10. Collections indexées
    11. Collections avec clés
    12. Manipuler les objets
    13. Détails du modèle objet
    14. Using promises
    15. Itérateurs et générateurs
    16. Meta-programmation
    17. JavaScript modules
  5. Intermédiaire
    1. Introducing JavaScript objects
    2. Client-side web APIs
    3. Réintroduction à JavaScript
    4. Structures de données en JavaScript
    5. Différents tests d'égalité
    6. Closures
  6. Avancé
    1. Héritage et la chaîne de prototypes
    2. Mode strict
    3. Tableaux typés en JavaScript
    4. Gestion de la mémoire
    5. Concurrence et boucle des événements
  7. Références :
  8. Objets natifs
    1. Array
    2. ArrayBuffer
    3. AsyncFunction
    4. Atomics
    5. BigInt
    6. BigInt64Array
    7. BigUint64Array
    8. Boolean
    9. DataView
    10. Date
    11. Error
    12. EvalError
    13. Float32Array
    14. Float64Array
    15. Function
    16. Generator
    17. GeneratorFunction
    18. Infinity
    19. Int16Array
    20. Int32Array
    21. Int8Array
    22. InternalError
    23. Intl
    24. Intl.Collator
    25. Intl.DateTimeFormat
    26. Intl.DisplayNames [Traduire]
    27. Intl.ListFormat
    28. Intl.Locale
    29. Intl.NumberFormat
    30. Intl.PluralRules
    31. Intl.RelativeTimeFormat
    32. JSON
    33. Map
    34. Math
    35. NaN
    36. Number
    37. Object
    38. Promise
    39. Proxy
    40. RangeError
    41. ReferenceError
    42. Reflect
    43. RegExp
    44. Set
    45. SharedArrayBuffer
    46. String
    47. Symbol
    48. SyntaxError
    49. TypeError
    50. TypedArray
    51. URIError
    52. Uint16Array
    53. Uint32Array
    54. Uint8Array
    55. Uint8ClampedArray
    56. WeakMap
    57. WeakSet
    58. WebAssembly
    59. decodeURI()
    60. decodeURIComponent()
    61. encodeURI()
    62. encodeURIComponent()
    63. escape()
    64. eval()
    65. globalThis
    66. isFinite()
    67. isNaN()
    68. null
    69. parseFloat()
    70. parseInt()
    71. undefined
    72. unescape()
    73. uneval()
  9. Expressions & opérateurs
    1. Opérateurs arithmétiques
    2. Compréhensions de tableau
    3. Opérateurs d'affectation
    4. Opérateurs binaires
    5. L'opérateur virgule
    6. Opérateurs de comparaison
    7. L'opérateur conditionnel
    8. Affecter par décomposition
    9. Expression closures
    10. L'opérateur function
    11. Compréhensions de générateur
    12. Opérateur de groupement
    13. Fonction génératrice historique
    14. Opérateurs logiques
    15. Nullish coalescing operator [Traduire]
    16. Initialisateur d'objet
    17. Précédence des opérateurs
    18. Chaînage optionnel (optional chaining)
    19. Tube
    20. Accesseurs de propriétés
    21. Syntaxe de décomposition
    22. Expression async function
    23. await
    24. class
    25. L'opérateur delete
    26. Expression function*
    27. L'opérateur in
    28. instanceof
    29. L'opérateur new
    30. new.target
    31. super
    32. L'opérateur this
    33. L'opérateur typeof
    34. L'opérateur void
    35. yield
    36. yield*
  10. Instructions & déclarations
    1. Fonction génératrice historique
    2. async function
    3. bloc
    4. break
    5. class
    6. const
    7. continue
    8. debugger
    9. default
    10. do...while
    11. vide
    12. export
    13. for
    14. for await...of
    15. for each...in
    16. for...in
    17. for...of
    18. function
    19. function*
    20. if...else
    21. import
    22. import.meta
    23. label
    24. let
    25. return
    26. switch
    27. throw
    28. try...catch
    29. var
    30. while
    31. with
  11. Fonctions
    1. Fonctions fléchées
    2. Valeurs par défaut des arguments
    3. Définir une méthode
    4. Paramètres du reste (Rest parameters)
    5. arguments
    6. L'opérateur get
    7. L'opérateur set
  12. Classes
    1. Class fields
    2. constructor
    3. extends
    4. static
  13. Errors
    1. Error: Permission denied to access property "x"
    2. InternalError: too much recursion
    3. RangeError: argument is not a valid code point
    4. RangeError: invalid array length
    5. RangeError: invalid date
    6. RangeError: precision is out of range
    7. RangeError: radix must be an integer
    8. RangeError: repeat count must be less than infinity
    9. RangeError: repeat count must be non-negative
    10. ReferenceError: "x" is not defined
    11. ReferenceError: assignment to undeclared variable "x"
    12. ReferenceError: can't access lexical declaration`X' before initialization
    13. ReferenceError: deprecated caller or arguments usage
    14. ReferenceError: invalid assignment left-hand side
    15. ReferenceError: reference to undefined property "x"
    16. SyntaxError: "0"-prefixed octal literals and octal escape seq. are deprecated
    17. SyntaxError: "use strict" not allowed in function with "x" parameter
    18. SyntaxError: "x" is a reserved identifier
    19. SyntaxError: JSON.parse: bad parsing
    20. SyntaxError: Malformed formal parameter
    21. SyntaxError: Unexpected token
    22. SyntaxError: Using //@ to indicate sourceURL pragmas is deprecated. Use //# instead
    23. SyntaxError: a declaration in the head of a for-of loop can't have an initializer
    24. SyntaxError: applying the 'delete' operator to an unqualified name is deprecated
    25. SyntaxError: for-in loop head declarations may not have initializers
    26. SyntaxError: function statement requires a name
    27. SyntaxError: identifier starts immediately after numeric literal
    28. SyntaxError: illegal character
    29. SyntaxError: invalid regular expression flag "x"
    30. SyntaxError: missing ) after argument list
    31. SyntaxError: missing ) after condition
    32. SyntaxError: missing : after property id
    33. SyntaxError: missing ; before statement
    34. SyntaxError: missing = in const declaration
    35. SyntaxError: missing ] after element list
    36. SyntaxError: missing formal parameter
    37. SyntaxError: missing name after . operator
    38. SyntaxError: missing variable name
    39. SyntaxError: missing } after function body
    40. SyntaxError: missing } after property list
    41. SyntaxError: redeclaration of formal parameter "x"
    42. SyntaxError: return not in function
    43. SyntaxError: test for equality (==) mistyped as assignment (=)?
    44. SyntaxError: unterminated string literal
    45. TypeError: "x" has no properties
    46. TypeError: "x" is (not) "y"
    47. TypeError: "x" is not a constructor
    48. TypeError: "x" is not a function
    49. TypeError: "x" is not a non-null object
    50. TypeError: "x" is read-only
    51. TypeError: 'x' is not iterable
    52. TypeError: More arguments needed
    53. TypeError: Reduce of empty array with no initial value
    54. TypeError: X.prototype.y called on incompatible type
    55. TypeError: can't access dead object
    56. TypeError: can't access property "x" of "y"
    57. TypeError: can't assign to property "x" on "y": not an object
    58. TypeError: can't define property "x": "obj" is not extensible
    59. TypeError: can't delete non-configurable array element
    60. TypeError: can't redefine non-configurable property "x"
    61. TypeError: invalid 'in' operand "x"
    62. TypeError: cyclic object value
    63. TypeError: invalid 'instanceof' operand 'x'
    64. TypeError: invalid Array.prototype.sort argument
    65. TypeError: invalid arguments
    66. TypeError: invalid assignment to const "x"
    67. TypeError: property "x" is non-configurable and can't be deleted
    68. TypeError: setting a property that has only a getter
    69. TypeError: variable "x" redeclares argument
    70. URIError: malformed URI sequence
    71. Warning: -file- is being assigned a //# sourceMappingURL, but already has one
    72. SyntaxError: "x" is not a legal ECMA-262 octal constant
    73. Warning: Date.prototype.toLocaleFormat is deprecated
    74. Warning: JavaScript 1.6's for-each-in loops are deprecated
    75. Warning: String.x is deprecated; use String.prototype.x instead
    76. Warning: expression closures are deprecated
    77. Warning: unreachable code after return statement
  14. Plus
    1. Aperçu des technologies JavaScript
    2. Grammaire lexicale
    3. Structures de données en JavaScript
    4. Rattachement des propriétés
    5. Protocoles d'itération
    6. Mode strict
    7. Passer au mode strict
    8. Gabarit de chaîne de caractère
    9. Fonctionnalités dépréciées
  15. Nouveautés de JavaScript
    1. Support d'ECMAScript 6 par Mozilla
    2. Support d'ECMAScript 5 par Mozilla
    3. Liste des changements liés à JavaScript par version de Firefox
    4. Nouveautés de JavaScript 1.1
    5. Nouveautés de JavaScript 1.2
    6. Nouveautés de JavaScript 1.3
    7. Nouveautés de JavaScript 1.4
    8. Nouveautés de JavaScript 1.5
    9. Nouveautés de JavaScript 1.6
    10. Nouveautés de JavaScript 1.7
    11. Nouveautés de JavaScript 1.8
    12. Nouveautés de JavaScript 1.8.1
    13. Nouveautés de JavaScript 1.8.5
  16. Documentation :
  17. Listes utiles
    1. Index des pages
    2. Index des méthodes
    3. Index des propriétés
    4. Pages étiquetées "JavaScript"
  18. Contribuer
    1. Statut de la documentation
    2. Le projet MDN