RegExp.prototype.toString()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

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

Dans cet article

Exemple interactif

console.log(new RegExp("a+b+c"));
// Expected output: /a+b+c/

console.log(new RegExp("a+b+c").toString());
// Expected output: "/a+b+c/"

console.log(new RegExp("bar", "g").toString());
// Expected output: "/bar/g"

console.log(new RegExp("\n", "g").toString());
// Expected output (if your browser supports escaping): "/\n/g"

console.log(new RegExp("\\n", "g").toString());
// Expected output: "/\n/g"

Syntaxe

regexObj.toString();

Valeur de retour

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

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 :

js
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.

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

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