1. 简介

🧐 基于 JavaScript 实现的逻辑规则计算库，可以通过添加逻辑和对比条件来快速计算数据是否符合要求。

2. 使用方法

2.1 安装依赖

npm install logical-rule-computation --save
yarn add logical-rule-computation
pnpm add logical-rule-computation

2.2 基础案例

/*
  1.按需引入核心函数、常数与类型
*/
import {
  calc,
  LOGICAL_OPERATOR,
  type RuleOptions,
} from "logical-rule-computation";

/*
  2.提供计算规则
    - 采用数组模板可更轻量地存储在数据库中
    - 规则中可嵌套任意数量和种类运算符

  如下案例为 a==1 && b.b1>1 && (b.b3===null || b.b3!==null)
*/
const rules: RuleOptions = [
  LOGICAL_OPERATOR.ALL,
  [
    ["==", "a", 1, "a == 1"],
    [">", "b.b1", 1, "b > 1"],
    [
      LOGICAL_OPERATOR.ANY,
      [
        ["eq", "b.b3", null, "b.b3 === null"],
        ["neq", "b.b3", null, "b.b3 !== null"],
      ],
      "b.b3 === null || b.b3 !== null",
    ],
  ],
  "a == 1 && b > 1",
];

/* 3.提供待计算数据源（支持嵌套对象，可如上案例进行扁平化书写读取属性） */
const origin = { a: 1, b: { b1: 2, b3: null } };

/*
  4.调用核心函数进行计算
  第三个参数支持自定义配置，如generateReport控制是否生成计算报告
*/
const report = calc(rules, origin, { generateReport: true });

console.log(report);

2.3 运算符

1. 逻辑运算符

需要引入内置枚举类型常量LOGICAL_OPERATOR

| | 书写方式 | 备注 | | ---- | ---------------------- | ---- | | 与 | LOGICAL_OPERATOR.ALL | | | 或 | LOGICAL_OPERATOR.ANY | |

2. 内置比较运算符

备注为底层计算原理，其中a表示待计算数据源，b表示规则中对应的值

| | 书写方式 | 备注 | | -------- | -------- | ---------------------------------- | | 大于 | > | a > b | | 小于 | < | a < b | | 大于等于 | >= | a >= b | | 小于等于 | <= | a <= b | | 相等 | == | a == b | | 不相等 | != | a != b | | 全等 | === | a === b | | 不全等 | !== | a !== b | | 包含 | in | Array.isArray(b) && b.includes(a) | | 不包含 | nin | Array.isArray(b) && !b.includes(a) |

3. 自定义比较运算符

import { calc, type Operations } from "local-rule-computation";
/*
  自定义比较运算符通过键值对传入，其中key为书写方式，value为计算方法
  计算方法中接收两个参数，其中a表示待计算数据源，b表示规则中对应的值
*/
const customOperations: Operations = {
  between: (a: any, b: any) => Array.isArray(b) && a >= b[0] && a <= b[1],
};

// 通过配置项operations传入，并且其优先级高于内置比较运算符，可进行覆写
calc(rules, origin, {
  operations:customOperations
})