鸿蒙开发：正则中的match和matchAll

前言

本文基于Api13

关于正则表达式，其实之前也撰写过相关文章，但没有对match和matchAll做过详细的分析，虽然都是用于常见的字符串匹配，但是在使用方式上还是具有一定的区别；大家记住一点，正则表达式适用于所有的编程语言，可能有些语法和使用方式有些不同，但基本的原理是一样的。

我们先看下源码：

match：将字符串与正则表达式匹配，并返回一个包含该搜索结果的数组。

/**
     * Matches a string with a regular expression, and returns an array containing the results of that search.
     * @param regexp A variable name or string literal containing the regular expression pattern and flags.
     */
    match(regexp: string | RegExp): RegExpMatchArray | null;

matchAll：将字符串与正则表达式匹配，并返回匹配项的可迭代对象

获取搜索结果。

/**
     * Matches a string with a regular expression, and returns an iterable of matches
     * containing the results of that search.
     * @param regexp A variable name or string literal containing the regular expression pattern and flags.
     */
    matchAll(regexp: RegExp): IterableIterator<RegExpMatchArray>;

我们从源码中也能看到，两者的参数和返回值也是有着一定的区别，在开发中，如果是一个字符串，可以直接调用到这两个方法。

相关介绍

match方法

首先，match呢，它是字符串对象的一个方法，用于在字符串中查找与正则表达式匹配的内容，可以接收两个类型的参数，一个是string，另一个是RegExp对象。

其中，string是要进行匹配的字符串，RegExp是一个正则表达式对象或字符串，有一点需要注意，如果RegExp不是正则表达式对象，则会隐式地将其转换为正则表达式对象。

match方法的返回值取决于正则表达式是否包含全局匹配标志g，这个还是蛮重要的，首先，如果正则表达式包含g标志，那么match方法将返回一个包含所有匹配结果的数组；如果不包含g标志，match方法将返回一个数组，数组的第一个元素是匹配的字符串，后续元素是捕获组的内容。如果没有匹配到任何内容，则返回null。

matchAll方法

matchAll方法是用于在字符串中查找所有与正则表达式匹配的内容，并返回一个迭代器，只接收RegExp对象，和match方法不同的是，必须包含全局匹配标志g，否则就会报错。

matchAll方法返回一个迭代器，每个迭代项都是一个包含匹配结果的数组。每个数组的第一个元素是匹配的字符串，后续元素是捕获组的内容。如果没有匹配到任何内容，则返回一个空的迭代器。

主要区别

格式要求

这个，上述已经说过了，也就是标志g，match方法对正则表达式没有特殊要求，可以包含或不包含g标志；matchAll方法要求正则表达式必须包含g标志，否则会就会报错。

返回值

match方法的返回值是一个RegExpMatchArray数组或null。如果正则表达式包含g标志，返回的数组包含所有匹配的字符串；如果不包含g标志，返回的数组包含匹配的字符串和捕获组的内容；而matchAll方法的返回值是一个迭代器，每个迭代项都是一个包含匹配结果的数组。每个数组包含匹配的字符串和捕获组的内容。

使用场景

match方法适用于简单的匹配操作，尤其是当只需要匹配第一个结果或不需要全局匹配时，而matchAll方法适用于需要获取所有匹配结果及其捕获组的场景，尤其是在处理复杂的正则表达式时。

使用方式

match方法

有一个简单的字符串，需要从中提取所有的数字，我们简单实现一下：

const content = "程序员一鸣88是一个非常优秀的66程序员"
const regex = /\d+/g
const result = content.match(regex)
console.log( JSON.stringify(result))

在这个例子中，我们使用match方法提取了字符串中的所有数字。由于正则表达式包含g标志，match方法返回了一个包含所有匹配结果的数组。

输出结果：

["88","66"]

matchAll方法

有一个字符串，需要从中提取所有的日期及其组成部包含年、月、日，我们就可以如下操作：

const str = "今天是 2025-03-23,明天是 2025-03-24, 后天是 2025-03-25"
const regex = /(\d{4})-(\d{2})-(\d{2})/g
const result = Array.from(str.matchAll(regex))
result.forEach(match => {
  console.log("===结果: "+match[0]+", 年: "+match[1]+", 月: "+match[2]+", 日: "+match[3]+"");
})

在这个例子中，我们使用matchAll方法提取了字符串中的所有日期及其组成部分。由于正则表达式包含g标志，matchAll方法返回了一个迭代器，我们将其转换为数组后，可以方便地访问每个匹配结果及其捕获组。

match和matchAll做下比较

有一个字符串，需要从中提取所有的电子邮件地址及其用户名和域名：

const str = "简单列举几个邮箱地址，111@qq.com or aaaaa@163.com"
const regex = /(\w+)@(\w+\.\w+)/g
// 使用match方法
const matchResult = str.match(regex)
console.log("===" + JSON.stringify(matchResult))
// 使用matchAll方法
const matchAllResult = Array.from(str.matchAll(regex))
matchAllResult.forEach(match => {
  console.log("===结果: " + match[0] + ", @前: " + match[1] + ", @后: " + match[2] + "")
});

我们看下结果：

在这个例子中，match方法只能返回匹配的电子邮件地址，而matchAll方法可以返回每个电子邮件地址及其用户名和域名。因此，matchAll方法在处理需要捕获组的场景时更为强大。

相关总结

在实际的开发中，match和matchAll是两个非常常见的的正则表达式方法；match方法适用于简单的匹配操作，而matchAll方法则适用于需要获取所有匹配结果及其捕获组的场景。