Méthode match() de la chaîne JavaScript

Définition et utilisation

match() La méthode fait correspondre une chaîne de caractères à une expression régulière.

Conseil :Si la valeur de recherche est une chaîne de caractères, elle est convertie en expression régulière.

match() La méthode retourne un tableau contenant les éléments correspondants.

Si aucune correspondance n'est trouvée, alors match() La méthode retourne null.

Veuillez également consulter :

Tutoriel sur les expressions régulières

Guide de l'expression régulière

Différence entre String match() et String search()

match() La méthode retourne un tableau de correspondances.

search() La méthode retourne la position de la première correspondance.

Exemple

Exemple 1

Recherche de "ain" en utilisant une chaîne de caractères :

let text = "The rain in SPAIN stays mainly in the plain";
text.match("ain");

Essayez-le vous-même

Exemple 2

Recherche de "ain" en utilisant une expression régulière :

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/);

Essayez-le vous-même

Exemple 3

Recherche globale pour "ain" :

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);

Essayez-le vous-même

Exemple 4

Recherche globale, sans distinction de cas :

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);

Essayez-le vous-même

Syntaxe

string.match(regexp)

Paramètre

Paramètre Description
regexp

Obligatoire. Valeur de recherche.

Expression régulière (ou chaîne de caractères qui sera convertie en expression régulière).

Valeur de retour

Type Description
Tableau ou null

Tableau contenant les éléments correspondants.

Si aucune correspondance n'est trouvée, retourne null.

Détails techniques

Paramètre regexp

Ce paramètre spécifie l'objet RegExp du motif à correspondre. Si ce paramètre n'est pas un objet RegExp, il est d'abord passé à la constructeur RegExp(), pour le convertir en objet RegExp.

Valeur de retour

Tableau d'éléments correspondants. Le contenu de cet tableau dépend de regexp a-t-elle le drapeau global g. Voici une explication détaillée de ce retour.

Explication

match() La méthode recherchera la chaîne stringpour trouver un ou plusieurs regexp de correspondre. Ce comportement dépend beaucoup de regexp a-t-elle le drapeau g.

si regexp sans le drapeau g, alors match() La méthode ne peut être utilisée que dans string Si aucune correspondance de texte n'est trouvée,match() une seule fois dans nullsera retourné string la position dans string de la référence.

si regexp a le drapeau gsi match() La méthode exécutera une recherche globale, trouvant string toutes les sous-chaînes correspondantes. Si aucune sous-chaîne correspondante n'est trouvée, alors retourne null. Si une ou plusieurs sous-chaînes correspondantes sont trouvées, un tableau est retourné. Cependant, le contenu du tableau retourné par la correspondance globale est très différent de celui des deux premiers, ses éléments du tableau contiennent string toutes les sous-chaînes correspondantes, et n'ont pas de propriété index ou input.

Attention :Dans le mode de recherche globale,match() C'est-à-dire, ni l'information sur le texte correspondant aux sous-expressions, ni la déclaration de la position de chaque sous-chaîne correspondante. Si vous avez besoin de ces informations de recherche globale, vous pouvez utiliser RegExp.exec().

Méthodes de recherche d'expression régulière

En JavaScript, la recherche de texte avec des expressions régulières peut être effectuée de différentes manières.

En utilisant le modèle comme expression régulière, celles-ci sont les méthodes les plus courantes :

Exemple Description
text.match(pattern) Méthode match() de la chaîne
text.search(pattern) Méthode search() de la chaîne
pattern.exec(text) Méthode exec() de l'expression régulière
pattern.test(text) Méthode test() de l'expression régulière

Support du navigateur

match() C'est une caractéristique ECMAScript1 (ES1).

Tous les navigateurs supportent complètement ES1 (JavaScript 1997) :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support Support Support Support Support Support

Pages associées

Chaîne JavaScript

Méthodes de chaîne JavaScript

Recherche de chaîne JavaScript