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

CKTIS / JavaScript

String.prototype.match — correspondances d’expressions régulières

La méthode match() recherche les correspondances d’une expression régulière dans une chaîne. Le drapeau g modifie la forme du résultat : sans lui, on obtient au plus une correspondance avec ses groupes capturants ; avec lui, un tableau de correspondances complètes. En l’absence de correspondance, le résultat est null.

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

string.match(regexp)

String.prototype.match recherche les correspondances d’un motif dans une chaîne sans modifier celle-ci. Avec un objet RegExp standard, le résultat est un tableau ou null si rien ne correspond. Vérifiez que le résultat n’est pas null avant d’accéder à ses éléments.

Si ni g ni y ne sont activés, la méthode renvoie la première correspondance, s’il y en a une. Avec y mais sans g, elle cherche une correspondance commençant exactement à la position obtenue en appliquant ToLength à la valeur actuelle de lastIndex. Elle peut donc renvoyer une correspondance plus loin dans la chaîne, ou renvoyer null même si le motif correspond ailleurs dans la chaîne. Par exemple, si lastIndex vaut -1 pour /a/y, le motif trouve une correspondance à l’indice 0 dans 'a'. Pour une correspondance trouvée sans g, l’élément 0 contient la correspondance complète et les éléments suivants contiennent les groupes capturants. La propriété index indique la position de la correspondance en unités de code UTF-16, et input contient la chaîne recherchée. Avec g, le tableau contient les correspondances complètes qui ne se chevauchent pas, mais ne contient ni les groupes capturants ni ces métadonnées. Sans y, la recherche peut sauter les portions de la chaîne qui séparent les correspondances. Avec g et y, elle s’arrête dès que le motif ne correspond pas à la position courante. Par exemple, 'a a'.match(/a/gy) ne renvoie que ['a'], même si un autre a se trouve à l’indice 2. Pour conserver les groupes de plusieurs correspondances, utilisez matchAll().

Un argument de type chaîne est interprété comme un motif d’expression régulière, et non comme du texte littéral : "abc".match(".")[0] produit "a". Omettre l’argument ou transmettre undefined crée un motif vide ; le résultat est donc une correspondance avec la chaîne vide, et non null.

Techniquement, la méthode délègue à Symbol.match si l’argument fournit cette méthode. Une implémentation personnalisée peut donc renvoyer un type de résultat différent ; le comportement décrit ci-dessus concernant le tableau correspond au comportement standard de RegExp.

Exemples

const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));

Résultat

["item-12","12",0]
["item-12","item-34"]
null

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