matcher-collection 是一个能够帮助开发者进行字符串和正则表达式匹配的 npm 包。下面将详细介绍该包的使用方法，以及具体的示例代码。
安装
首先，需要在项目中安装该包。可以通过以下命令进行安装：
npm install matcher-collection
使用方法
基本用法
使用 matcher-collection 的最基本方式是创建一个实例并添加一些匹配规则。如下所示：
-- -------------------- ---- ------- ----- ----------------- - ------------------------------ ----- ------- - --- -------------------- ----------------------- -- --------- ---------------------- -- ----------- ------------------------------------- -- ---- ------------------------------- --------- -- ---- ----------------------------------- -- -----
在上述示例中，我们创建了一个名为 matcher 的实例，并向其添加了两个匹配规则（一个字符串规则和一个正则表达式规则）。然后我们调用了 test() 方法来测试一些输入，该方法返回一个布尔值来表示输入是否与任何一个规则匹配。
高级用法
除了基本用法之外，matcher-collection 还提供了一些高级功能，例如支持设置全局配置、支持异步规则等等。下面是一些常见的高级用法：
全局配置
可以通过传递一个配置对象来设置 matcher-collection 的全局配置。下面是一个例子：
const MatcherCollection = require('matcher-collection');
const matcher = new MatcherCollection({
caseSensitive: false, // 不区分大小写
});
matcher.add('example'); // 添加一个字符串规则
console.log(matcher.test('EXAMPLE')); // true在上述示例中，我们传递了一个 { caseSensitive: false } 的配置对象来设置不区分大小写。然后我们添加了一个字符串规则，并测试了一个大写的输入，由于该配置生效，因此测试返回的结果为 true。
异步规则
matcher-collection 还支持异步规则。可以通过传递一个返回 Promise 的函数来实现异步规则。下面是一个例子：
-- -------------------- ---- ------- ----- ----------------- - ------------------------------ ----- ------- - --- -------------------- ----------------- ------- -- - ----- ---- - ----- ------------ -- ------ ------ --------------------- -- ------ --- ----------------- ------------------------------ -- ---- ----------------- ---------------------------- -- -----
在上述示例中，我们向 matcher 添加了一个异步规则，该规则使用 fetchData() 方法从外部源异步获取数据，然后检查输入是否存在于该数据中。我们还演示了如何使用 testAsync() 方法来测试异步规则。
示例代码
下面是一些常见的 matcher-collection 使用场景的示例代码：
匹配任意数字
const MatcherCollection = require('matcher-collection');
const matcher = new MatcherCollection();
matcher.add(/^\d+$/); // 添加一个正则表达式规则
console.log(matcher.test('123')); // true
console.log(matcher.test('abc')); // false匹配一组字符串
const MatcherCollection = require('matcher-collection');
const matcher = new MatcherCollection();
matcher.add(['foo', 'bar']); // 添加一个字符串数组规则
console.log(matcher.test('foo')); // true
console.log(matcher.test('baz')); // false匹配一个 URL
-- -------------------- ---- ------- ----- ----------------- - ------------------------------ ----- ------- - --- ------------------- -------------- ------ -- ------ --- -------------------------------------------- -- ----------- ----------------------------------------------------- -- ---- ---------------------------------------------------- -- ---- ----------------------------------------------------- -- -----
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/46214