Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

RegExp.prototype.source — texte du motif d’expression régulière

La propriété source renvoie le texte d’un motif RegExp sans les barres obliques qui l’entourent ni ses drapeaux. Elle permet d’examiner un motif ou de le reconstruire avec new RegExp(), en transmettant les drapeaux séparément.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

regexp.source

RegExp.prototype.source est une propriété d’accesseur dotée d’un getter, mais sans setter. Lisez-la sous la forme regexp.source, sans parenthèses d’appel. Le résultat est une chaîne contenant le motif, sans les délimiteurs / qui l’entourent ni les drapeaux. Ceux-ci se lisent séparément avec regexp.flags.

Le résultat convient à la représentation du motif dans un littéral d’expression régulière : les barres obliques et les caractères de fin de ligne sont échappés de manière appropriée. Il n’est donc pas nécessairement identique au texte transmis au constructeur. Pour un motif vide, new RegExp("").source renvoie "(?:)", et non une chaîne vide. La lecture de RegExp.prototype.source elle-même renvoie également "(?:)".

Pour reconstruire le motif et ses drapeaux, utilisez new RegExp(regexp.source, regexp.flags). Cela crée un nouvel objet ; l’état de lastIndex n’est pas copié. source ne transforme pas un texte quelconque en motif littéral sûr : les opérateurs d’expression régulière présents conservent leur signification.

Le getter exige un véritable objet RegExp, avec RegExp.prototype lui-même comme exception particulière. Appeler le getter avec un autre récepteur déclenche une TypeError. Affecter une valeur à la propriété source ordinaire héritée ne modifie pas le motif : cela déclenche une TypeError en mode strict et est ignoré dans les autres cas.

Exemples

const pattern = /a\/b+/gi;
const copy = new RegExp(pattern.source, pattern.flags);

console.log(pattern.source);
console.log(pattern.flags);
console.log(copy.test("A/BBB"));
console.log(new RegExp("").source);

Résultat

a\/b+
gi
true
(?:)

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources