From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../global_objects/regexp/@@match/index.md | 111 +++++++++------------ 1 file changed, 48 insertions(+), 63 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/regexp/@@match') diff --git a/files/fr/web/javascript/reference/global_objects/regexp/@@match/index.md b/files/fr/web/javascript/reference/global_objects/regexp/@@match/index.md index 9d3c824406..0126ab2d2f 100644 --- a/files/fr/web/javascript/reference/global_objects/regexp/@@match/index.md +++ b/files/fr/web/javascript/reference/global_objects/regexp/@@match/index.md @@ -11,54 +11,56 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/RegExp/@@match original_slug: Web/JavaScript/Reference/Objets_globaux/RegExp/@@match --- -
{{JSRef}}
+{{JSRef}} -

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

+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_). -
{{EmbedInteractiveExample("pages/js/regexp-prototype-@@match.html")}}
+{{EmbedInteractiveExample("pages/js/regexp-prototype-@@match.html")}} -

Syntaxe

+## Syntaxe -
regexp[Symbol.match](str)
+ regexp[Symbol.match](str) -

Paramètres

+### Paramètres -
-
str
-
La chaîne de caractères ({{jsxref("String")}}) sur laquelle on veut chercher des correspondances.
-
+- `str` + - : La chaîne de caractères ({{jsxref("String")}}) sur laquelle on veut chercher des correspondances. -

Valeur de retour

+### Valeur de retour -

Un tableau ({{jsxref("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 {{jsxref("null")}}.

+Un tableau ({{jsxref("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 {{jsxref("null")}}. -

Description

+## Description -

Cette méthode est appelée de façon interne lorsqu'on utilise {{jsxref("String.prototype.match()")}}. Ainsi, les deux exemples qui suivent sont équivalents et le second est la version interne du premier :

+Cette méthode est appelée de façon interne lorsqu'on utilise {{jsxref("String.prototype.match()")}}. Ainsi, les deux exemples qui suivent sont équivalents et le second est la version interne du premier : -
'abc'.match(/a/);
+```js
+'abc'.match(/a/);
 
-/a/[Symbol.match]('abc');
+/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.

+Cette méthode existe afin de permettre d'adapter le comportement de la recherche des correspondances pour les sous-classes de `RegExp`. -

Exemples

+## Exemples -

Appel direct

+### Appel direct -

Cette méthode peut être utilisée comme {{jsxref("String.prototype.match()")}} mais avec un objet this différent et un ordre des paramètres également différent.

+Cette méthode peut être utilisée comme {{jsxref("String.prototype.match()")}} mais avec un objet `this` différent et un ordre des paramètres également différent. -
var re = /[0-9]+/g;
+```js
+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

+### Utilisation de `@@match` avec une sous-classe -

Les sous-classes de {{jsxref("RegExp")}} peuvent surcharger la méthode [@@match]() afin de modifier le comportement.

+Les sous-classes de {{jsxref("RegExp")}} peuvent surcharger la méthode `[@@match]()` afin de modifier le comportement. -
class MaRegExp extends RegExp {
+```js
+class MaRegExp extends RegExp {
   [Symbol.match](str) {
     var résultat = RegExp.prototype[Symbol.match].call(this, str);
     if (!résultat) return null;
@@ -76,41 +78,24 @@ 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ÉtatCommentaires
{{SpecName('ES6', '#sec-regexp.prototype-@@match', 'RegExp.prototype[@@match]')}}{{Spec2('ES6')}}Définition initiale.
{{SpecName('ESDraft', '#sec-regexp.prototype-@@match', 'RegExp.prototype[@@match]')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.RegExp.@@match")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES6', '#sec-regexp.prototype-@@match', 'RegExp.prototype[@@match]')}} | {{Spec2('ES6')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-regexp.prototype-@@match', 'RegExp.prototype[@@match]')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.RegExp.@@match")}} + +## Voir aussi + +- {{jsxref("String.prototype.match()")}} +- {{jsxref("RegExp.prototype.@@replace()", "RegExp.prototype[@@replace]()")}} +- {{jsxref("RegExp.prototype.@@search()", "RegExp.prototype[@@search]()")}} +- {{jsxref("RegExp.prototype.@@split()", "RegExp.prototype[@@split]()")}} +- {{jsxref("RegExp.prototype.exec()")}} +- {{jsxref("RegExp.prototype.test()")}} -- cgit v1.2.3-54-g00ecf