La méthode toString() renvoie une chaîne de caractères représentant l'expression rationnelle.

Syntaxe

regexObj.toString();

Valeur de retour

Une chaîne de caractères représentant l'expression rationnelle appelante.

Description

L'objet RegExp surcharge la méthode toString de l'objet Object. Il n'hérite donc pas de Object.prototype.toString(). Pour les objets RegExp, la méthode toString() renvoie une représentation de l'expression rationnelle sous la forme d'une chaîne de caractères.

Exemple

Utiliser toString()

L'exemple qui suit affiche la chaîne correspondant à la valeur de l'objet RegExp :

var maRegExp = new RegExp("a+b+c");
console.log(maRegExp.toString());  // affiche "/a+b+c/"

var toto = new RegExp("truc", "g");
console.log(toto.toString());      // affiche "/truc/g"

Les expressions ratonnelles vides et l'échappement

À partir d'ECMAScript 5, la méthode renvoie la chaîne "(?:)" pour les expressions vides. De plus, les fins de lignes (telles que "\n") sont désormais échappées.

new RegExp().toString(); // "(?:)"

new RegExp('\n').toString() === "/\n/";  // true avant ES5
new RegExp('\n').toString() === "/\\n/"; // true à partir d'ES5

Spécifications

Spécification État Commentaires
ECMAScript 3rd Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
La définition de 'RegExp.prototype.toString' dans cette spécification.
Standard source renvoie désormais "(?:)" (et non "") pour les expressions vides. La définition du comportement pour les échappements a été ajoutée.
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'RegExp.prototype.toString' dans cette spécification.
Standard  
ECMAScript Latest Draft (ECMA-262)
La définition de 'RegExp.prototype.toString' dans cette spécification.
Projet  

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple Oui Oui1 Oui Oui Oui
Escaping Oui Oui38 Oui Oui Oui
Generic function ? ?39 ? ? ?
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple Oui Oui Oui4 Oui Oui ?
Escaping Oui Oui Oui38 Oui Oui ?
Generic function ? ? ?39 ? ? ?

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,