介绍
Grock 是一个基于文本模式匹配的 JavaScript 库，它可以帮助开发者解析和验证各种格式的文本数据。该库支持简单到 IP 地址、URL 和日期，复杂到自定义正则表达式等多种类型的数据解析。
Grock 既可以在浏览器端使用，也可以在 Node.js 中使用，而且它的 API 简单易用，非常适合用来处理用户输入的数据或解析日志文件等场景。
安装
你可以通过 npm 安装 grock：
npm install grock
或者将其添加到 dependencies 中：
{
"dependencies": {
"grock": "^1.0.0"
}
}使用
基本语法
Grock 的基础语法很简单，就是一组由花括号包围的占位符，每个占位符代表一个要匹配的字段，例如：
const pattern = '{verb} {adjective} {noun}';
const grock = new Grock();
grock.addPattern(pattern);
const result = grock.parse('run fast car');
console.log(result);
// 输出：{ verb: 'run', adjective: 'fast', noun: 'car' }在上面的例子中，我们定义了一个匹配模式，然后使用 parse 方法对输入字符串进行解析，并得到一个包含解析结果的对象。
预定义模式
Grock 内置了一些常用的预定义模式，例如：
%{WORD}：匹配由非空字符组成的单词。%{INT}：匹配整数。%{IP}：匹配 IP 地址。%{URI}：匹配 URL。%{TIMESTAMP_ISO8601}：匹配 ISO 8601 格式的时间戳。
你可以在模式中使用这些预定义模式占位符，例如：
const pattern = '%{IP} %{WORD} %{INT}';
const grock = new Grock();
grock.addPattern(pattern);
const result = grock.parse('192.168.1.1 example 123');
console.log(result);
// 输出：{ IP: '192.168.1.1', WORD: 'example', INT: '123' }自定义模式
除了预定义模式外，你还可以定义自己的匹配模式。例如，如果我们想要匹配一个长度为 10 的随机字符串，可以这样定义一个自定义模式：
const pattern = '%{RANDOM_STRING:10}';
const grock = new Grock();
grock.addPattern(pattern, { RANDOM_STRING: () => Math.random().toString(36).substring(2) });
const result = grock.parse('u44oqvj5e8');
console.log(result);
// 输出：{ RANDOM_STRING: 'u44oqvj5e8' }在上面的例子中，我们定义了一个名为 RANDOM_STRING 的自定义模式，它通过一个函数生成一个长度为 10 的随机字符串。然后我们将这个模式添加到 Grock 实例中，就可以使用它来匹配输入字符串了。
处理错误
在解析文本时，可能会遇到无法匹配的情况。Grock 提供了两种处理错误的方式：返回 null 或者抛出异常。你可以通过 setDefaultHandler 方法设置默认的错误处理方式，例如：
-- -------------------- ---- ------- ----- ------- - -------- --------- ----- ----- - --- -------- -------------------------- ------------------------------- -------- -- - --------------------- ------------ -- ------------- ------ ----- --- ----- ------ - ------------------- -- --------- -------- -------- -- ----- -------------------- -- -------
如果你不想使用默认的错误处理方式，也可以为每个 parse 调
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/51937