如果你曾经在前端项目中使用魔方表格组件，你可能已经了解了 cube notation，这是一种用于描述魔方表格模型的语法。cube notation 除了可以方便地描述模型之外，它还可以用来描述数据集、统计指标等，因此它在 BI 报表领域有着很广泛的应用。
然而，cube notation 语法并未被正式规定，因此不同的前端组件库和后端 BI 工具的 cube notation 语法可能会存在差异。如果你经常和不同的 cube notation 语法打交道，将会带来一些困扰。这时候，npm 包 cube-notation-normalizer 可能会帮助你解决这个问题。
什么是 cube-notation-normalizer？
cube-notation-normalizer 是一个用于将不同形式的 cube notation 语法转化为标准形式的 npm 包。标准形式是指，虽然不同的后端 BI 工具的 cube notation 语法可能存在差异，但是它们都能被转化为一个固定的、定义明确的标准形式。cube-notation-normalizer 就是用来做这件事的。
该包的核心功能是将不同形式的 cube notation 语法转化为标准形式的 JSON 格式，这样方便程序进行处理，避免了不同格式的 cube notation 语法带来的混乱和错误。
使用 cube-notation-normalizer
使用 cube-notation-normalizer 很简单。首先，你需要使用 npm 安装该包：
npm install cube-notation-normalizer
然后，在你的代码中引入该包：
const cn = require('cube-notation-normalizer');接着，你可以使用 cn.normalize() 方法将任意形式的 cube notation 转化为标准形式的 JSON 格式。
假设你有这样一个 cube notation:
SELECT Measures.Revenue ON COLUMNS, Region.Members ON ROWS, FROM [Sales] WHERE [Time].[2016].[Q1]
你可以使用以下代码将其转化为标准形式：
-- -------------------- ---- ------- ----- -- - ------------------------------------ ----- -------- - - ------ ---------------- -- -------- -------------- -- ----- ---- ------- ----- ------------------ -- ----- ------------------ - ----------------------- --------------------------------
输出的结果应该是一个标准化的 JSON 对象：
-- -------------------- ---- -------
-
--------- -
---------- -
-
--------- ------------------
-
-
--
------- -
--------- ---------
--
-------- -
---------- -
-
------------ ---------
-------- -------
--------- ----
-
-
--
------- -
-
--------- ----------------
-
-
-这个标准化后的 JSON 对象，就可以被其他的程序方便地处理了。
深入理解 cube-notation-normalizer
如果你希望深入地理解 cube-notation-normalizer 是如何工作的，下面是一些你需要了解的信息：
- cube-notation-normalizer 使用正则表达式来匹配不同的 cube notation 语法；
- 该包根据不同的匹配结果，使用不同的函数来将 cube notation 转化为标准化的 JSON 对象；
- 在转化的过程中，该包还会根据传入的选项对 cube notation 进行一些修复和优化，比如修复语法错误、移除无用的语句等；
- 如果你需要使用不同的转化规则，你可以通过修改该包的源代码来实现。
总结
在 BI 报表领域，cube notation 语法被广泛使用。不同的组件库和工具可能会使用不同的 cube notation 语法，这会给前端工程师带来很大的困扰。npm 包 cube-notation-normalizer 提供了一种简单而有效的解决方案，可以将不同形式的 cube notation 转化为标准形式，从而方便程序进行处理。使用该包非常简单，只需要引入包并调用 normalize 方法即可。如果你希望深入了解该包是如何工作的，你可以查看其源代码，对照正则表达式和转化规则进行理解。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60056ce681e8991b448e6989