RegExp | NN 4 IE 4 ECMA 3
L'objet statique RegExp a une double fonction: il génère des instances d'une expression régulière et contrôle toutes les expressions régulières de la fenêtre ou du cadre considéré. Les instances de l'objet RegExp sont présentées dans la description de l'objet expression régulière à la suite de cette section.
Les expressions régulières facilitent la recherche de textes correspondant à des combinaisons de caractères ou de caractéristiques. Par exemple, une expression régulière permet de déterminer très rapidement si l'entrée d'un champ de texte est un nombre à cinq chiffres. Pour définir le modèle de correspondance, il faut connaître la syntaxe de notation qui n'est pas traitée dans ce manuel (vous trouverez toutes les informations nécessaires à ce sujet dans l'ouvrage de Jeffrey E.F. Friedl, Mastering Regular Expressions, publié par O'Reilly). La description de l'objet expression régulière contient une brève présentation de la syntaxe.
Les propriétés de l'objet RegExp stockent des informations sur la dernière opération d'une expression régulière dans le document. Par conséquent, il est parfaitement concevable que chaque propriété change après une opération d'expression régulière. Ces opérations incluent non seulement les méthodes d'une instance d'objet expression régulière (exec() et test()), mais aussi les méthodes d'objet String qui acceptent des expressions régulières comme paramètres (match(), replace() et split()). Certaines de ces propriétés sont également passées à l'objet expression régulière, en prévision de la prochaine opération d'expression régulière.
Outre un nom descriptif, chaque propriété porte également un nom raccourci commençant par le signe $.
Propriétés
index | input | lastIndex | lastMatch | lastParen | leftContext
multiline | prototype | rightContext | $1 | $2 | $3
$4 | $5 | $6 | $7 | $8 | $9

index | NN s.o. IE 4 ECMA s.o.
| Lecture seule
Valeur d'index à base zéro correspondant à la position du caractère de la chaîne où a commencé la dernière recherche du modèle. La propriété lastIndex fournit la position de fin.
Exemple
    var srchStart = RegExp.index;
Valeur
Nombre entier.

input | NN 4 IE 4 ECMA s.o.
| Lecture/écriture
Chaîne principale à laquelle une expression régulière est comparée. Si la chaîne principale est passée à l'opération d'expression régulière comme paramètre pour une méthode, cette valeur est null. La version courte est $_ (signe dollar, caractère de soulignement).
Exemple
    RegExp.input = "Four score and seven years ago...";
Valeur
Chaîne.

lastIndex | NN s.o. IE 4 ECMA s.o.
| Lecture/écriture
Valeur d'index à base zéro correspondant au caractère de la chaîne où commence la prochaine recherche du modèle. Dans une recherche, la valeur est égale à zéro. Vous pouvez également définir la valeur manuellement si vous souhaitez commencer à un autre emplacement ou omettre certains caractères. Cette propriété est reflétée dans l´instance d´objet de l´expression régulière et c´est là qu´elle est prise en charge dans Navigator.
Exemple
    myRE.lastIndex = 30;
Valeur
Nombre entier.

lastMatch | NN 4 IE 5(Mac)/5.5(Win) ECMA s.o.
| Lecture seule
Renvoie la chaîne correspondant à l'expression régulière, suite à la dernière opération. La version courte est $&.
Exemple
    var matched = RegExp.lastMatch;
Valeur
Chaîne.

lastParen | NN 4 IE 5(Mac)/5.5(Win) ECMA s.o.
| Lecture seule
Renvoie la chaîne correspondant au dernier sous-composant entre parenthèses de l'expression régulière résultant de la dernière opération. La version courte est $+.
Exemple
    var myValue = RegExp.lastParen;
Valeur
Chaîne.

leftContext, rightContext | NN 4 IE 5(Mac)/5.5(Win) ECMA s.o.
| Lecture seule
La propriété leftContext renvoie la chaîne commençant par le début du dernier texte recherché et se terminant juste avant l'occurrence de la chaîne. La propriété rightContext renvoie la chaîne commençant par la partie de la chaîne principale située juste derrière l'occurrence trouvée et s'étendant jusqu'à la fin de la chaîne. Les versions courtes sont respectivement $` et $'. Etant donné que l'exécution de recherches successives sur une même chaîne principale se déplace inéluctablement vers la fin de celle-ci, le point de départ de la valeur leftContext peut être décalé à chaque opération.
Exemple
    var wholeContext = RegExp.leftContext + RegExp.lastMatch + RegExp.rightContext;
Valeur
Chaîne.

multiline | NN 4 IE 5(Mac)/5.5(Win) ECMA 3
| Lecture/écriture
Si la recherche porte sur plusieurs lignes de texte, la propriété multiline est définie sur true. Par exemple, une recherche dans le texte d'un élément textarea est de multilignes. La version courte est $*.
Exemple
    if (RegExp.multiline) {
        ...
    }
Valeur
Booléen.

prototype | NN 4 IE 4 ECMA 3
| Lecture/écriture
Reportez-vous à cette propriété de l´objet Array.

$1, ..., $9 | NN 4 IE 4 ECMA s.o.
| Lecture seule
Sous-composants entre parenthèses des résultats renvoyés par une expression régulière. Ces résultats sont stockés individuellement dans des propriétés libellées de 1 à 9 et précédées du symbole de raccourci $. L'ordre dépend de la position de la parenthèse de gauche d'un sous-composant: Le résultat du sous-composant à l´extrême gauche est placé dans $1. Ces propriétés peuvent être insérées directement dans des paramètres de méthodes String qui utilisent des expressions régulières (voir la méthode String.replace()).
Exemple
    RegExp.$2
Valeur
Chaîne.