La méthode [@@match]()
permet de récupérer les correspondances obtenues lorsqu'on teste une chaîne de caractères par rapport à une expression rationnelle (regexp).
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
regexp[Symbol.match](str)
Paramètres
str
- La chaîne de caractères (
String
) sur laquelle on veut chercher des correspondances.
Valeur de retour
Un tableau (Array
) qui contient les résultats des correspondances et les groupes capturés grâce aux parenthèse. S'il n'y a aucune correspondance, ce sera null
.
Description
Cette méthode est appelée de façon interne lorsqu'on utilise String.prototype.match()
. Ainsi, les deux exemples qui suivent sont équivalents et le second est la version interne du premier :
'abc'.match(/a/);
/a/[Symbol.match]('abc');
Cette méthode existe afin de permettre d'adapter le comportement de la recherche des correspondances pour les sous-classes de RegExp
.
Exemples
Appel direct
Cette méthode peut être utilisée comme String.prototype.match()
mais avec un objet this
différent et un ordre des paramètres également différent.
var re = /[0-9]+/g;
var str = '2016-01-02';
var résultat = re[Symbol.match](str);
console.log(résultat); // ["2016", "01", "02"]
Utilisation de @@match
avec une sous-classe
Les sous-classes de RegExp
peuvent surcharger la méthode [@@match]()
afin de modifier le comportement.
class MaRegExp extends RegExp {
[Symbol.match](str) {
var résultat = RegExp.prototype[Symbol.match].call(this, str);
if (!résultat) return null;
return {
group(n) {
return résultat[n];
}
};
}
}
var re = new MaRegExp('([0-9]+)-([0-9]+)-([0-9]+)');
var str = '2016-01-02';
var résultat = str.match(re); // String.prototype.match appelle re[@@match].
console.log(résultat.group(1)); // 2016
console.log(résultat.group(2)); // 01
console.log(résultat.group(3)); // 02
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'RegExp.prototype[@@match]' dans cette spécification. |
Standard | Définition initiale. |
ECMAScript (ECMA-262) La définition de 'RegExp.prototype[@@match]' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser