# @comunica/utils-expression-evaluator 中文文档

规范地址：https://npmcn.com/package/%40comunica/utils-expression-evaluator/

版本：5\.4\.0
npm 元数据更新时间：2026-10-22T07:40:25.149Z
中文译文更新时间：2026-11-10T14:42:29.642Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40comunica/utils-expression-evaluator
原文对照：https://npmcn.com/package/%40comunica/utils-expression-evaluator/?lang=original
项目主页：https://comunica.dev/
源码仓库：https://github.com/comunica/comunica

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：339 kB，60 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：7 个
- 首次发布：2024-10-08T10:20:00.600Z
- 最新版本发布：2026-09-14T09:10:03.972Z
- 近 30 天下载量：242262（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 11 个）

## 中文简介

一个简单的 SPARQL 表达式评估器

## 安装

```sh
npm install @comunica/utils-expression-evaluator
```

也可以使用：`pnpm add @comunica/utils-expression-evaluator`、`yarn add @comunica/utils-expression-evaluator`、`bun add @comunica/utils-expression-evaluator`

## README

# Comunica 表达式评价器

[![npm version](https://badge.fury.io/js/%40comunica%2Fexpression-evaluator.svg)](https://www.npmjs.com/package/@comunica/expression-evaluator)

之前称为 sparqlee - sparql 表达评价器. 一个简单的符合光谱的SPARQL 1.1表达式评价器包.

**[更多地了解表达式评估者](https://comunica.dev/docs/modify/advanced/expression-evaluator/)。 。 。 .**

这个模块是 [通信框架](https://github.com/comunica/comunica), (中文(简体) ), 并且只能用于 [想要建立自己的查询引擎的开发者](https://comunica.dev/docs/modify/)。 。 。 .

[如果您想要询问Comunica, 请点击这里](https://comunica.dev/docs/query/)。 。 。 .

## 安装

```bash
$ yarn add @comunica/utils-expression-evaluator
```

## 已曝光课程

-   [`ExpressionEvaluator`](https://comunica.github.io/comunica/classes/_comunica_expression_evaluator.AsyncEvaluator.html): 评估与承诺合作的SPARQL表达式.
-   [`IAsyncEvaluatorContext`](https://comunica.github.io/comunica/classes/_comunica_expression_evaluator.IAsyncEvaluatorContext.html): 用于配置上下文 `ExpressionEvaluator`。见 [配置](https://comunica.dev/docs/modify/advanced/expression-evaluator/#config)。 。 。 .
-   [`SyncEvaluator`](https://comunica.github.io/comunica/classes/_comunica_expression_evaluator.SyncEvaluator.html): SPARQL 表达式的评价员,不承诺工作.
-   [`ISyncEvaluatorContext`](https://comunica.github.io/comunica/interfaces/_comunica_expression_evaluator.ISyncEvaluatorContext.html): 用于配置上下文 `SyncEvaluator`。见 [配置](https://comunica.dev/docs/modify/advanced/expression-evaluator/#config)。 。 。 .
-   [`AggregateEvaluator`](https://comunica.github.io/comunica/classes/_comunica_expression_evaluator.AggregateEvaluator.html): SPARQL 汇总表达式的评估者,在不承诺的情况下工作。 见 [合计数](https://comunica.dev/docs/modify/advanced/expression-evaluator/#aggregates)。 。 。 .
-   [`ExpressionError`](https://comunica.github.io/comunica/classes/_comunica_expression_evaluator.ExpressionError.html): 用于 SPARQL 表达式错误的错误类,定义为 [错误区域](https://comunica.dev/docs/modify/advanced/expression-evaluator/#errors)。 。 。 .
-   [`isExpressionError`](https://comunica.github.io/comunica/functions/_comunica_expression_evaluator.isExpressionError.html): 检查错误类型的方法 `ExpressionError`。 。 。 .
-   [`orderTypes`](https://comunica.github.io/comunica/functions/_comunica_expression_evaluator.orderTypes.html): 根据 [按规格排列的 SPARQL 命令](https://www.w3.org/TR/sparql11-query/#modOrderBy)。 。 。 .
-   [`AsyncAggregateEvaluator`](https://comunica.github.io/comunica/classes/_comunica_expression_evaluator.AsyncAggregateEvaluator.html): SPARQL 组合表达式的评估者,与承诺配合。 见 [合计数](https://comunica.dev/docs/modify/advanced/expression-evaluator/#aggregates)。 。 。 .

## 发展

## 本地设置

1.  安装 `yarn` 财务报告和审定财务报表 `node`。 。 。 .
2.  运行 `yarn install`。 。 。 .
3.  使用这些已显示的命令( 或检查) `package.json`:
    -   新建一次: `yarn run build`

### 布局和控制流量

SPARQL代数表达式可以被转换为内部代表(参见: [代数转换器.ts](https://npmcn.com/package/%40comunica/actor-expression-evaluator-factory-default/lib/AlgebraTransformer.ts)) (中文(简体) ). 这将构建对象( 见 [表达式模块](https://npmcn.com/package/%40comunica/utils-expression-evaluator/lib/expressions)),包含所有用于评价的逻辑和数据. 改造后,评估人员将对所有表达方式进行再评价.

### 测试

测试环境的设置是为了用很少的代码进行大量的测试. 负责流利行为的文件位于 [`test/util`](https://npmcn.com/package/%40comunica/utils-expression-evaluator/test/util) 模块. 大多数测试可以通过运行 `runTestTable` 方法输入 [倾斜](https://npmcn.com/package/%40comunica/utils-expression-evaluator/test/util/utils.ts)。 。 。 . 这种方法需要测试表 。 多个测试运行在一个测试表上(每行一个). 如果还提供了别名,则测试表可能包含别名 (一些手动别名居住在 [别名.ts](https://npmcn.com/package/%40comunica/utils-expression-evaluator/test/util/Aliases.ts)) (中文(简体) ). 这意味着当测试诸如 `"3"^^xsd:integer equals "3"^^xsd:integer` 实值 `"true"^^xsd:boolean`。 。 。 . 我们将写一个小表格(例如,增加一些测试),并像这样测试:

```js
import { bool, merge, numeric } from './util/Aliases';
import { Notation } from './util/TruthTable';
import { runTestTable } from './util/utils';
runTestTable({
  testTable: `
       3i 3i = true
       3i -5i = false
       -0f 0f = true
       NaN  NaN = false
   `,
  arity: 2,
  operation: '=',
  aliases: merge(numeric, bool),
  notation: Notation.Infix,
});
```

可提供更多的选项,并按以下论据的类型定义加以解释: `runTestTable`。 。 。 .

我们还可以提供 `errorTable` 页:1 `runTestTable` 方法. 如果我们想要测试某些参数上调用某些函数会抛出我们想要的错误,则使用此选项 . 一个例子是测试是否 `Unknown named operator` 当 我们不提供扩展功能的执行.

```js
import { bool, merge, numeric } from './util/Aliases';
import { Notation } from './util/TruthTable';
import { runTestTable } from './util/utils';
runTestTable({
  errorTable: `
       3i 3i = 'Unknown named operator'
       3i -5i = 'Unknown named operator'
       -0f 0f = 'Unknown named operator'
       NaN  NaN = 'Unknown named operator'
   `,
  arity: 2,
  operation: '<https://example.org/functions#equal>',
  aliases: merge(numeric, bool),
  notation: Notation.Infix,
});
```

当你不在乎错误是什么, 你可以只是测试 `''`。 。 。 .

如果表格对您进行测试的限制太大,您需要评估. 你还是应该用 `generalEvaluate` 函数从 [总体评价.ts](https://npmcn.com/package/%40comunica/utils-expression-evaluator/test/util/generalEvaluation.ts)。 。 。 . 此函数将在可能时自动同时运行同步和同步. 这增加了你的检查范围.

## 常见问题

### @comunica/utils-expression-evaluator 是什么？

一个简单的 SPARQL 表达式评估器

### 如何安装 @comunica/utils-expression-evaluator？

在项目目录运行 npm install @comunica/utils-expression-evaluator，或使用 pnpm add / yarn add / bun add。

### @comunica/utils-expression-evaluator 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @comunica/utils-expression-evaluator 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @comunica/utils-expression-evaluator 可以商用吗？

@comunica/utils-expression-evaluator 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @comunica/utils-expression-evaluator 的下载量有多少？

根据 npm 官方下载统计，@comunica/utils-expression-evaluator 在 2026/10/11 – 2026/11/09 这 30 天内被下载 242,262 次，日均约 8,075 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @comunica/utils-expression-evaluator 还在维护吗？

最新版本 5\.4\.0 发布于 2026/09/14（1 个月前）；至今共发布 20 个版本，其中过去 12 个月发布了 11 个；首次发布于 2024/10/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。