RegExp.prototype.toString()

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.

Exemples

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 (ECMA-262)
La définition de 'RegExp.prototype.toString' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi