# @as-pect/transform 中文文档

规范地址：https://npmcn.com/package/%40as-pect/transform/

版本：9\.0\.0
npm 元数据更新时间：2026-06-17T23:16:46.323Z
中文译文更新时间：2026-11-06T21:59:50.163Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40as-pect/transform
原文对照：https://npmcn.com/package/%40as-pect/transform/?lang=original

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

- 包体积（解压后）：63 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2022-08-24T03:20:49.869Z
- 最新版本发布：2026-06-17T23:16:46.136Z
- 近 30 天下载量：7968（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 1 个）

## 中文简介

由"活塞"核心和组装套件所采用的能实现严格平等的变相.

## 安装

```sh
npm install @as-pect/transform
```

也可以使用：`pnpm add @as-pect/transform`、`yarn add @as-pect/transform`、`bun add @as-pect/transform`

## README

# `@as-pect/transform`

Assembly脚本变换为 `as-pect` 反思支持.

此套件执行类反射转换. 它注入运行时帮助者在其中生成的类反射形状 `@as-pect/assembly` 取决于测试时比较类实例或打印反映的对象值.

## 生成形状

对于在源文件和命名空间中发现的每个类声明,变换附件有两个公共实例方法:

-   `__aspectStrictEquals(rawRef: Object, stack: usize[], cache: usize[], ignore: StaticArray<i64>): bool`
-   `__aspectAddReflectedValueKeyValuePairs(reflectedValue: i32, seen: Map<usize, i32>, ignore: StaticArray<i64>): void`

这些方法名称具有相容性敏感性. `packages/assembly/assembly/internal/Reflect.ts` 当它不能使用内置比较或反射值路径时直接调用它们.

## 类别折叠 变形

`ClassReflectionTransform` 是拥有生成的类反射行为的共享类成员计划模块。 它检查每类一次,并记录参与严格平等和反映关键/价值生成的个案成员.

成员计划按来源顺序包括:

-   实例字段
-   实例获取器

成员计划不包括:

-   静态成员
-   常规实例方法
-   继承成员,由产生的成员处理 `super` 电话

每个计划成员都携带其名称、来源范围、获得者/实地类型,以及 `djb2` 名为散列. 生成的方法通过这些散列 `ignore: StaticArray<i64>` 调用时 `super` 因此,继承产生的方法不会重复被儿童阶级压倒的成员.

散列值故意仍然是与已生成代码的相容性接合。 如果两个继承成员的名字在 `djb2`,生成的被忽略列表将它们作为相同的继承成员对待,并用决定性的方式压制了母条目;变换不重命名成员或尝试运行时倒置.

## 世代责任

阶级反省产生分出几个狭义的责任:

-   `index.ts` 行走解析出的来源和命名空间,然后代表分类和界面声明到生成模块.
-   `appendGeneratedClassReflectionMembers.ts` 产生成员合同或接口合同的管弦乐团应附后,包括一能检查和用户授权的碰撞出错.
-   `ClassReflectionTransform.ts` 拥有兼容性敏感的生成成员名,生成成员标记,类相/相相相撞检查,本地平等操作器检测,以及类相会成员计划.
-   `createStrictEqualsMember.ts`, (中文(简体) ), `createAddReflectedValueKeyValuePairsMember.ts`,以及 `createInterfaceReflectionMembers.ts` 为每个运行时法形状构建生成的 AssemblyScript AST .

这使得转录,规划,碰撞政策,以及AST构造保持了足够分化,以至于改变一个生成的方法不需要重新学习每一个变换规则.

## 运行时间关系

`@as-pect/assembly` 在两个地方使用生成的方法:

1.  `Reflect.equals()` 电话 `__aspectStrictEquals` 用于在结构上比较类例.
2.  `Reflect.toReflectedValue()` 电话 `__aspectAddReflectedValueKeyValuePairs` 以添加反射对象密钥和值.

因此,变换和运行时间共享一个接合:变换拥有生成的方法形状,运行时间假设形状在编译后存在 `@as-pect/transform`。 。 。 .

## 兼容性预期

-   两种生成的方法名称保持不变,除非计划协调运行时间迁移.
-   留着 `ignore` 如此传承和被推翻的成员的行为稳定,没有两次报告.
-   保持生成的行为不依赖性;这个软件包应该保持局部小变换.
-   在增加反映/与平等有关的成员时,保留源顺序,使记者产出保持稳定.
-   为同一解析出源保持变换生成同位素;重复的通行证不应附加重复生成的成员.
-   拒绝用户授权 `__aspectStrictEquals` 或者说 `__aspectAddReflectedValueKeyValuePairs` 成员有明显的变形错误,而不是默默地覆盖它们.

## 常见问题

### @as-pect/transform 是什么？

由"活塞"核心和组装套件所采用的能实现严格平等的变相\.

### 如何安装 @as-pect/transform？

在项目目录运行 npm install @as-pect/transform，或使用 pnpm add / yarn add / bun add。

### @as-pect/transform 支持 TypeScript 吗？

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

### @as-pect/transform 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @as-pect/transform 可以商用吗？

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

### @as-pect/transform 的下载量有多少？

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

### @as-pect/transform 还在维护吗？

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