# @gerhobbelt/ast-util 中文文档

规范地址：https://npmcn.com/package/%40gerhobbelt/ast-util/

版本：0\.6\.1-4
npm 元数据更新时间：2022-04-05T13:58:05.879Z
中文译文更新时间：2026-11-16T05:15:01.488Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40gerhobbelt/ast-util
原文对照：https://npmcn.com/package/%40gerhobbelt/ast-util/?lang=original
项目主页：https://github.com/eventualbuddha/ast-util
源码仓库：https://github.com/GerHobbelt/ast-util

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

- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>= 4\.0
- 运行依赖：2 个
- 首次发布：2017-08-27T13:55:11.305Z
- 最新版本发布：2017-08-27T13:55:11.305Z
- 近 30 天下载量：24407（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

AST变压器的公用事业.

## 安装

```sh
npm install @gerhobbelt/ast-util
```

也可以使用：`pnpm add @gerhobbelt/ast-util`、`yarn add @gerhobbelt/ast-util`、`bun add @gerhobbelt/ast-util`

## README

# 用户

AST变压器的公用事业.

## 安装

```
$ npm install [--save] ast-util
```

## API 密码

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-callArraySlice) **调用箭头切片**(单位:千美元)_范围_, (中文(简体) ), _节点_\[, _开始_, (中文(简体) ), _结束_)

返回一个呼叫到 `Array.prototype.slice` 与 `node` 作为上下文 `begin` 财务报告和审定财务报表 `end` 作为论据 `slice`。 。 。 .

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-callFunctionBind) **调用函数**(单位:千美元)_范围_, (中文(简体) ), _fn 时_, (中文(简体) ), _上下文_\[, _参数_)

返回一个呼叫到 `Function.prototype.bind` 使用任意一种 `call` 或者说 `apply` 视价值而定 `args` 没错 若为 `args` 是一个表达式 `apply` 已使用。 若为 `args` 是一系列表达式,然后 `call`。 。 。 .

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-callGet) **调用**(单位:千美元)_范围_, (中文(简体) ), _对象_, (中文(简体) ), _属性_, (中文(简体) ), _接收器_(中文(简体) )

对象的内部方法看起来像 [帮助/获得.js](https://npmcn.com/package/%40gerhobbelt/ast-util/helpers/get.js)。 。 。 .

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-callGetOwnPropertyDescriptor) **调用 GetOwnProperty 描述器**(单位:千美元)_范围_, (中文(简体) ), _对象_, (中文(简体) ), _属性_(中文(简体) )

返回一个呼叫到 `Object.getOwnPropertyDescriptor` 用给定的 `object` 财务报告和审定财务报表 `property`。 。 。 .

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-callGetPrototypeOf) **调用 GetPrototype Of**(单位:千美元)_范围_, (中文(简体) ), _对象_(中文(简体) )

返回一个呼叫到 `Object.getPrototypeOf` 用给定的 `object`。 。 。 .

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-callHasOwnProperty) **呼叫 HasOwn 财产**(单位:千美元)_范围_, (中文(简体) ), _节点_, (中文(简体) ), _属性_(中文(简体) )

返回一个呼叫到 `hasOwnProperty` 与 `node` 作为上下文 `property` 作为 要检查的财产.

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-callSharedMethod) **调用共享方法**(单位:千美元)_范围_, (中文(简体) ), _被调用者_, (中文(简体) ), _参数_(中文(简体) )

返回给定的呼叫 `callee` 与 `args` 作为论据。 若为 `callee` 是一个字符串,然后将其作为全球可访问函数,例如 `Object.defineProperty` 它将被存储在一个独特的临时变量中. 随后对该函数的调用将重新使用相同的临时变量.

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-callSharedMethodWithContext) **调用带文字的共享方法**(单位:千美元)_范围_, (中文(简体) ), _被调用者_, (中文(简体) ), _上下文_, (中文(简体) ), _参数_(中文(简体) )

返回给定的呼叫 `callee` 与 `context` 作为方法上下文和 `args` 作为论据。 若为 `callee` 是一个字符串,然后把它当作一个 全球可访问功能,例如: `Array.prototype.slice` 这将是 存储在一个独特的临时变量中。 后续调用此功能 重新使用相同的临时变量.

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-getGlobals) **获取全球**(单位:千美元)_现值_(中文(简体) )

获得一个标识符列表,以在 给定 `ast`。假设此代码的坐标为:

```js
var a;
function b(){ return c; }
b(d);
```

礛 `getGlobals` 将返回两个标识, `c` 财务报告和审定财务报表 `d`。 。 。 .

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-identifierForString) **标识符**(单位:千美元)_字符串_(中文(简体) )

生成给定字符串的安全 JavaScript 标识符 .

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-injectShared) **输入共享**(单位:千美元)_范围_, (中文(简体) ), _名称_, (中文(简体) ), _表达式_(中文(简体) )

注入带有唯一标识符的共享变量。 只有第一通电话 同样的 `scope` 财务报告和审定财务报表 `name` 将会导致可变声明 创建。 这个 `expression` 传入可以是 AST 节点,也可以是函数到 生成一个。 此函数一般用于注入重复使用的值 并且防止重复处决.

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-injectVariable) **可注入变量**(单位:千美元)_范围_, (中文(简体) ), _标识符_\[, _输入_)

用给定输入变量 `identifier` 输入给定 `scope` 作为 `var` 带有可选初始值的声明.

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-isReference) **参考**(单位:千美元)_路径_(中文(简体) )

确定是否给定 `path` 是一个值参考。 譬如说, `a` 财务报告和审定财务报表 `b` 是参考文献,但 `c` 不为:

```js
a(b.c);
```

只有标识符算作参考.

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-isUsed) **已使用**(单位:千美元)_范围_, (中文(简体) ), _名称_(中文(简体) )

确定是否给定 `name` 在给定中,应被视为“使用” `scope`。要使用一个名称,它应当:

1.  在此范围或母范围中宣布.
2.  在这一范围、父母范围或任何子女范围中都提及.

譬如说, `a`, (中文(简体) ), `b`,以及 `d` 用于本实例的全球范围 时 `c` 不为:

```js
var a;
function b() {}

try {
  a = b(d);
} catch (c) {
}
```

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-sharedFor) **共享为**(单位:千美元)_范围_, (中文(简体) ), _名称_(中文(简体) )

通过从被点出路径中获取命名值来注入共享变量。 对于 示例,此选项将返回一个可以用于替换命名的标识符 表达式 :

```js
sharedFor(scope, 'Object.defineProperty')
```

随后发出的呼吁 `sharedFor` 在同一范围内,将返回相同的范围 标识符.

[{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40gerhobbelt/ast-util/#readme-user-content-uniqueIdentifier) **唯一标识符**(单位:千美元)_范围_\[, _名称_)

生成一个标识符, 保证不会与给定中的任何其他人相冲突 `scope`。该函数也永远不会为 任意 `scope` 其全球范围已经具备了这一特征.

被称为没有全球参考和变量的范围,这是第一次 函数将返回一个名为 `$__0`。 。 。 .

使用前缀“$ ” 也许吧 如果已经使用此名称, 则会附加加号 直到它找到一个没有使用的名称.

## 使用量

这些方法对源变换很有用,例如转录器或宏. 这种转变往往需要将变量插入范围并取而代之 表达. 使用 `injectVariable` 财务报告和审定财务报表 `injectShared` 专用于 那个目的。 与 `ast-types`写一个简单的 版本 a `swap` 宏 :

```js
// var tmp;
var tmp = util.injectVariable(
  this.scope,
  util.uniqueIdentifier(this.scope)
);

this.replace(
  b.sequenceExpression([
    // tmp = left
    b.assignmentExpression(
      '=',
      tmp,
      left
    ),
    // left = right
    b.assignmentExpression(
      '=',
      left,
      right
    ),
    // right = tmp
    b.assignmentExpression(
      '=',
      right,
      tmp
    )
  ])
);
```

见 [实例/swap-macro.js](https://npmcn.com/package/%40gerhobbelt/ast-util/examples/swap-macro.js) 比较完整的 实例.

## 捐款

[![Build Status](https://travis-ci.org/eventualbuddha/ast-util.png?branch=master)](https://travis-ci.org/eventualbuddha/ast-util)

### 设置

首先,安装开发依赖:

```
$ npm install
```

然后,试运行测试:

```
$ make test
```

如果你要添加或编辑代码,将帮助者注入一个范围,你将需要 以 lib/ helpers 生成文件 帮助中的文件.

### 调取请求

1.  叉开它
2.  创建您的特性分支( E)`git checkout -b my-new-feature`(中文(简体) )
3.  提交更改( E)`git commit -am 'Add some feature'`(中文(简体) )
4.  推向分行(`git push origin my-new-feature`(中文(简体) )
5.  创建新的拉请求

## 鸣谢

谢谢 [本·纽曼](https://github.com/benjamn) 页:1 [屁股类型](https://github.com/benjamn/ast-types),其中很多 这个图书馆取决于.

## 常见问题

### @gerhobbelt/ast-util 是什么？

AST变压器的公用事业\.

### 如何安装 @gerhobbelt/ast-util？

在项目目录运行 npm install @gerhobbelt/ast-util，或使用 pnpm add / yarn add / bun add。

### @gerhobbelt/ast-util 支持 TypeScript 吗？

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

### @gerhobbelt/ast-util 支持 ESM 还是 CommonJS？

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

### @gerhobbelt/ast-util 需要什么版本的 Node\.js？

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

### @gerhobbelt/ast-util 可以商用吗？

@gerhobbelt/ast-util 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @gerhobbelt/ast-util 的下载量有多少？

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

### @gerhobbelt/ast-util 还在维护吗？

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

