# @geosolutions/espree 中文文档

规范地址：https://npmcn.com/package/%40geosolutions/espree/

版本：3\.1\.8
npm 元数据更新时间：2022-04-05T13:57:23.052Z
中文译文更新时间：2026-11-16T04:57:20.760Z
软件包许可：BSD-2-Clause

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

原始 npm 页面：https://www.npmjs.com/package/%40geosolutions/espree
原文对照：https://npmcn.com/package/%40geosolutions/espree/?lang=original
项目主页：https://github.com/eslint/espree
源码仓库：https://github.com/geosolutions-it/espree

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

- 包体积（解压后）：75.4 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=0\.10\.0
- 运行依赖：2 个
- 首次发布：2019-12-02T16:20:42.855Z
- 最新版本发布：2019-12-02T16:20:43.240Z
- 近 30 天下载量：7887（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

在橡树上建造的相容的 JavaScript 解析器

## 安装

```sh
npm install @geosolutions/espree
```

也可以使用：`pnpm add @geosolutions/espree`、`yarn add @geosolutions/espree`、`bun add @geosolutions/espree`

## README

# 叉线信息

这回贷被扣了,因为我们需要加注 [这个](https://github.com/geosolutions-it/espree/tree/58084900bd57afdcfe0b9dca80ca9a1419c1d693) 修补 我们将出版 **释放** npm 地产登记册上的分支

# 埃斯布雷语Name

Espree最初是作为一个叉子 [埃斯皮里亚](http://esprima.org/) v1.2.2,Esprima在ECMAScript 6工作开始前发布的最后一张平面版. 埃斯普雷现在建在 [橡子](https://github.com/ternjs/acorn),它有一个模块化架构,允许扩展核心功能. 埃斯普雷的目标是生产出与埃斯普里马相类似的输出,具有相近的API,从而可以被用来代替埃斯普里马.

## 使用量

安装 :

```
npm i espree --save
```

在你的节点代码里:

```javascript
var espree = require("espree");

var ast = espree.parse(code);
```

还有一个理由: `parse()` 可以指定各种选项:

```javascript
var espree = require("espree");

var ast = espree.parse(code, {

    // attach range information to each node
    range: true,

    // attach line/column location information to each node
    loc: true,

    // create a top-level comments array containing all comments
    comment: true,

    // attach comments to the closest relevant node as leadingComments and
    // trailingComments
    attachComment: true,

    // create a top-level tokens array containing all tokens
    tokens: true,

    // specify the language version (3, 5, 6, or 7, default is 5)
    ecmaVersion: 5,

    // specify which type of script you're parsing (script or module, default is script)
    sourceType: "script",

    // specify additional language features
    ecmaFeatures: {

        // enable JSX parsing
        jsx: true,

        // enable return in global scope
        globalReturn: true,

        // enable implied strict mode (if ecmaVersion >= 5)
        impliedStrict: true,

        // allow experimental object rest/spread
        experimentalObjectRestSpread: true
    }
});
```

## Esprima 相容性前进

首要目标是制作与Esprima完全相同的AST结构和道具,这优先于其他任何东西. (AST结构是 [爱沙尼亚](https://github.com/estree/estree) API与JSX扩展. ) 除此以外,Espree还可能偏离Esprima在评论的附后位置和方式以及AST节点上有哪些补充信息。 也就是说,Espree在AST节点上添加的东西可能比Esprima多,但生产的整体AST结构会是一样的.

Espree也可能在其暴露的界面中偏离Esprima.

## 捐款

问题和拉动请求将分出三分,并尽快作出回应。 我们是在 [ESLint 贡献者准则](http://eslint.org/docs/developer-guide/contributing)所以请在投稿前读一下 如果你不知道在哪里挖,检查一下 [问题](https://github.com/eslint/espree/issues)。 。 。 .

Espree根据允许的BSD 2 Clause许可证获得许可证.

## 构建命令

-   `npm test` - 运行所有的衬衣和测试
-   `npm run lint` - 运行所有林丁
-   `npm run browserify` - 创建可用于浏览器的 Espree 版本

## 与Espree 2.x的差别

-   这个 `tokenize()` 方法不使用 `ecmaFeatures`。任何字符串都将完全根据ECMAScript 6语义来表示.
-   轨迹白地空间不再作为节点的一部分被计算.
-   `let` 财务报告和审定财务报表 `const` 声明不再被默认解析。 您必须选择使用 `ecmaFeatures.blockBindings`。 。 。 .
-   这个 `esparse` 财务报告和审定财务报表 `esvalidate` 二进制脚本已删除 .
-   没有 `tolerant` 选项。 以后我们再调查一下.

## 已知的不兼容性

为了帮助那些希望从其他参赛者向埃斯普雷过渡的人,下面列出了与其他参赛者明显的不相容之处. 我们不打算改变这些已知的分歧.

### 埃斯布里玛 1.2.2

-   Esprima计算出后面的白空间作为每个AST节点的一部分,而Espree则没有. 在埃斯普雷,一个节点的终点是最后一个标志发生的地方.
-   Espree 不分析 `let` 财务报告和审定财务报表 `const` 默认声明.
-   为解析错误而返回的错误消息是不同的 .
-   每个节点和信使上都有两个附加属性: `start` 财务报告和审定财务报表 `end`。这些数据与 `range` 并被橡树内部使用.

### 埃斯布里玛 2.x

-   Esprima 2.x使用不同的注释附件算法,导致一些注释被添加到与Espree不同的地方. Espree使用的算法与Esprima 1.2.2中使用的算法相同.

## 经常被问到的问题

### 为何还要再分析一下

[ESLint 语录](http://eslint.org/) 从一开始就一直依赖埃斯普里玛作为它的解析者。 虽然在JavaScript语言缓慢地发展时这一点很好,但发展速度却急剧加快,而Esprima已经落后了. ESLint与许多其他依赖于Esprima的工具一样,一直被卡住在使用新的JavaScript语言功能上直到Esprima更新,这引起了我们的用户的挫折.

我们决定了我们前进的唯一方式是创建自己的解析器,使我们与JSHint和JSLint保持一致,并允许我们继续落实我们需要的新特征。 我们选择了用叉子Esprima而不是从零开始,以便尽快用相容的API移动.

与 Espree 2.0.0 相比,我们不再是 Esprima 的分叉,而是一个从 Acorn 到 Esprima 语法之间的翻译层. 这样,我们就可以将工作重新纳入一个社区支持的橡树园(Acorn),它正在继续成长和发展,同时为那些仍在埃斯普里马建造的公用事业维持一个与埃斯普里马兼容的园林园.

### 你试过和埃斯普里玛合作吗?

对 从ESLint开始,我们经常向Esprima提交错误和特征请求,并将继续这样做. 然而,在项目如何运作的问题上有一些不同的哲学观点需要通过. 最初的目标是让Espree track Esprima,并最终将两者合并为一并,但我们最终决定,由于Acorn的插件支持,在Acorn上方建设是一个更好的选择.

### 你为什么不用橡子?

Acorn是一款伟大的JavaScript parser,它生产出一个兼容Esprima的AST. 不幸的是,ESLint不仅仅依靠AST来完成任务. 它依靠Esprima的符和注释附件特性来获得源代码的完整图片. 我们调查了切换到Acorn的情况,但是Esprima和Acorn之间的不一致为ESLint这样的项目创造了太多的工作.

然而,我们正在橡树顶上建设,这样我们才能作出贡献,帮助使橡树变得更好.

### 你支持什么ECMAScript 6 特性?

所有诸相.

### 你支持什么ECMAScript 7 特性?

只有一个ECMAScript 7的语法变化: exproventation操作器. Espree支持这一点.

### 你如何确定哪些实验特征可以支持?

一般来说,我们不支持实验性的JavaScript特性. 我们可以不时根据特征的成熟程度做出例外.

## 常见问题

### @geosolutions/espree 是什么？

在橡树上建造的相容的 JavaScript 解析器

### 如何安装 @geosolutions/espree？

在项目目录运行 npm install @geosolutions/espree，或使用 pnpm add / yarn add / bun add。

### @geosolutions/espree 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/geosolutions\_\_espree 是否存在。

### @geosolutions/espree 支持 ESM 还是 CommonJS？

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

### @geosolutions/espree 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=0\.10\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @geosolutions/espree 可以商用吗？

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

### @geosolutions/espree 的下载量有多少？

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

### @geosolutions/espree 还在维护吗？

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

