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 OuiEdge Support complet 12Firefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs 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.ListFormat
    27. Intl.Locale
    28. Intl.NumberFormat
    29. Intl.PluralRules
    30. Intl.RelativeTimeFormat
    31. JSON
    32. Map
    33. Math
    34. NaN
    35. Number
    36. Object
    37. Promise
    38. Proxy
    39. RangeError
    40. ReferenceError
    41. Reflect
    42. RegExp
    43. Set
    44. SharedArrayBuffer
    45. String
    46. Symbol
    47. SyntaxError
    48. TypeError
    49. TypedArray
    50. URIError
    51. Uint16Array
    52. Uint32Array
    53. Uint8Array
    54. Uint8ClampedArray
    55. WeakMap
    56. WeakSet
    57. WebAssembly
    58. decodeURI()
    59. decodeURIComponent()
    60. encodeURI()
    61. encodeURIComponent()
    62. escape()
    63. eval()
    64. globalThis
    65. isFinite()
    66. isNaN()
    67. null
    68. parseFloat()
    69. parseInt()
    70. undefined
    71. unescape()
    72. 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. Compréhensions de générateur
    11. Opérateur de groupement
    12. Fonction génératrice historique
    13. Opérateurs logiques
    14. Initialisateur d'objet
    15. Précédence des opérateurs
    16. Chaînage optionnel (optional chaining)
    17. Tube
    18. Accesseurs de propriétés
    19. Syntaxe de décomposition
    20. Expression async function
    21. await
    22. class
    23. L'opérateur delete
    24. L'opérateur function
    25. Expression function*
    26. L'opérateur in
    27. instanceof
    28. L'opérateur new
    29. new.target
    30. super
    31. L'opérateur this
    32. L'opérateur typeof
    33. L'opérateur void
    34. yield
    35. 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