# @ghostry/extern-extension-fabricator-v0 中文文档

规范地址：https://npmcn.com/package/%40ghostry/extern-extension-fabricator-v0/

版本：0\.0\.6
npm 元数据更新时间：2026-10-31T03:49:57.740Z
中文译文更新时间：2026-11-16T08:40:46.214Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ghostry/extern-extension-fabricator-v0
原文对照：https://npmcn.com/package/%40ghostry/extern-extension-fabricator-v0/?lang=original
项目主页：https://github.com/ghostry-dev/extern
源码仓库：https://github.com/ghostry-dev/extern

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

- 包体积（解压后）：17.8 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@ghostry/extern \>=0\.0\.14 \<0\.1\.0，@ghostry/fabricator \>=0\.0\.13 \<0\.1\.0
- 首次发布：2026-08-30T23:48:04.045Z
- 最新版本发布：2026-10-31T03:49:57.427Z
- 近 30 天下载量：2331（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

@ghostry/ 制造器集成@ghostry/ extern —— 一个由造型器 schema 所建的打出外形块.

## 安装

```sh
npm install @ghostry/extern-extension-fabricator-v0
```

也可以使用：`pnpm add @ghostry/extern-extension-fabricator-v0`、`yarn add @ghostry/extern-extension-fabricator-v0`、`bun add @ghostry/extern-extension-fabricator-v0`

## README

# @ghostry/ext-extension-factor-v0 (英语)

[`@ghostry/fabricator`](https://github.com/ghostry-dev/fabricator) 融合 页:1 [`@ghostry/extern`](https://github.com/ghostry-dev/extern)。 。 。 .

A 类 `typed` 由编织器构筑的外形块变成 **自我模拟**数字 : 没有模拟定义 它编造一个值 从自己的计划 而不是 掷出 `NotMockedError`。 。 。 .

## 设置

```ts
import { initialize as initializeExtern } from "@ghostry/extern";
import { initialize as initializeFabricator } from "@ghostry/fabricator";
import { fabricatorExtension } from "@ghostry/extern-extension-fabricator-v0";

const fabricator = initializeFabricator({ salt: "my-suite" });

export const extern = await initializeExtern({
  extensions: [fabricatorExtension({ instance: fabricator })],
});
```

扩大适用于 **仅此一次**。外部实例没有 扩展仍然拒绝编织器的图谋作为身份,就像以前一样.

只有计划是身份,从来不是造型的造型师. 说到这一点,一个街区要么继续其溪流,要么从它的图谋中重新建立起来,在呼叫站点,没有任何东西会说出什么。 传出它建造的图案.

## 用这个

```ts
const { T } = fabricator;

const user = T.object({
  id: T.number,
  name: T.string.whereby({ length: { max: 10 } }),
});

const load = () => extern.typed.by(user).will(() => fetchUser());
```

在一个测试区, `load()` 虚构a `{ id, name }` 没有嘲弄 写入 :

```ts
await extern.testing(() => {
  expect(load()).toMatchObject({ id: expect.any(Number) });
});
```

### 彻底压倒

```ts
await extern.testing((mock) => {
  mock(user).with({ id: 1, name: "Ada" });
});
```

### 制造制造

`produce()` 编造出一个间谍 有了回电,它会给你 构造的造型器,所以超能用造型器自己的词汇来表示—— 此软件包模型 :

```ts
await extern.testing((mock) => {
  mock(user).produce(({ via }) => via.fabricate({ name: "Ada" }));

  expect(load().name).toBe("Ada");
});
```

`via` 已经建构 `Fabricator`,所以一个对象的 `fabricate(overrides)` 携带 编织师自己的 `Override<Definition>` - 巢穴物体 `Omitted` 哨兵,还有所有。 其它的都够用, `trace` 财务报告和审定财务报表 `schema` 包含。 两者 `produce()` 财务报告和审定财务报表 `produce(fn)` **缓存** 百分比 `(identity, name)`: 回调一次,一次两次读出块 测试同意.

`via` 是一个造型的制造器,无论身份是哪种 每一个计划都有回调形式——而不仅仅是对象计划。 什麽 不同之处在于制造者所接受的: `fabricate` 带 覆盖, a `T.number`没有。 那是编织师自己喜欢说的, 不是这个套件规定的规则.

### 需要一个明确的模拟器

```ts
fabricatorExtension({ instance: fabricator, unmocked: "error" });
```

块后抛出 `NotMockedError` 除非被嘲笑,否则 `produce()` 还是 凭要求捏造.

## 决定主义

每个测试区都有一个新的建筑计数器 继承 编织器实例的盐和分层 一个已知的常数 在它上——从来没有 任何来源于一个块被写入的地方。 这使得:

-   同一个块 编织出相同的值 跨独立 `testing()` 电话
-   从不同测试文件中执行的相同方案得出相同的值
-   一个测试块内的构造顺序决定了未命名值

用户自己的 `new fabricator.Fabricator(schema)` 在测试块内写入 共享块的来源,但是一个 **单独绘图** 连续的正文 一流——不是第二取景区值.

一个写着 _外部_ 块取自附件范围。 这个 恒相地层是使这两道溪流不相通的原因: 测试块的一面永远无法与其中的一面相撞,在任何正弦.

在一次试验中,两个街区超过一个计划是单一生产. 给他们 `named(...)` 让他们与众不同.

一个名字比散开更有用 它能把一个街区从位置上移出 完全:一个被命名的块的值是它的身份和名称的函数, 没有别的——所以它仍然反对任何其它的考验 虚构先入. 在上面加个第二个固定器,或者一个助手 在路过的路程里编造出谎言 一个有名的街区保留着它的价值 一动一动. 这就是两种形式的交易 这就是为什么上面的子弹 范围为未命名的值.

### 用试带

`@ghostry/fabricator/harnessing` 打开一个 `wrap` 其每次试验的盐分 那测试的特性。 此扩展范围随后运行 _内部_ 和两个 巢而不是竞争:内部的块 `extern.testing` 继承附件 测试的盐, 和它的钟随它.

这种筑巢是故意的,而不是自动的。 A 类 `wrap` 把它的上方贴上 它被调用, 所以一个接收器捆绑在运行区块之外—— 所配置的实例总是——将从该实例中重申 缩小附件范围。 此扩展名的构成为: `context.scope()`,则 有效,这就是为什么每个测试盐到达.

建筑平面没有穿过——每个测试区块 如上所述,范围恒定的盐层保持了 区块的溪流与附加测试脱节,所以 `fabricate()` 写入 双方 `extern.testing` 从来不会和里面的一个相撞.

Extern自己的驾驭集成(`@ghostry/extern/harnessing`在这里作曲 并删除 `extern.testing` 呼叫:每个测试机构已经是一个街区. 两种整合的顺序决定了哪些范围包含哪些,等等 盐层的巢穴在命令中,没有别的。 任何命令都保留每个 层从 `@ghostry/fabricator` `v0.0.6` 向上并给出每个测试自己的数据;翻转它会移动每一个虚构值,所以选择一个并保存它.

为了在测试中获取编织器数据,叉出有效的范围,而不是 案例本身。 每一次测试 `wrap` 审理案件 `integration(...)` 和它的祖先,绝不是它的分叉

```ts
it("a", () => {
  fabricator.fork({ salt: layer("A") });
  // ["my-suite", "A"] — the same data in every test

  fabricator.context.scope().fork({ salt: layer("A") });
  // extern last:  ["my-suite", "test", "a", "@ghostry/extern", "A"]
  // extern first: ["my-suite", "@ghostry/extern", "test", "a", "A"]
});
```

赤叉无所起; 屏蔽自己 停留每个测试 很容易错过. `@ghostry/fabricator`绳子指南涵盖了规则.

绳子是自己的 `context.fabricator` 留在一个街区内。 它拿着 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}但是建筑工程解决了 与最内在的活性框架相对, 因此它与周围的块步入 这个.

两分之一必须来自 **一个 `initialize()`**数字 :

```ts
const fabricator = initializeFabricator({ salt: "my-suite" });

// harness integration and extension, one lineage
integration(fabricator);
fabricatorExtension({ instance: fabricator });
```

一个框架只可见于它自己祖传线上的实例. 两个 `initialize()` 调用与薄荷无关的线条, 并永不见相框 - 连交接也一样 `stack`,它选择了载体和无 再来 因此,一个扩展指 _第二届_ 从未观察到 绳索的框并回到自己的布局:每个试验盐是 每一次试验都是同样的,没有产生任何错误.

一行相相相相相相相相相相相相相相相相相相相相相相相无相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 延期必须证明 融合的例子或其祖先之一: `wrap` 永远 管理一个综合实例的分叉,所以将扩展分叉交给这样的分叉 失败的方式相同。 交出 _融合_ 延伸的分叉 没事.

决定主义生存下来; **特性** 没有。 症状是测试 写出一个编造的id, 形成共同的相撞状态—— 通过 一个人,作为一个套房失败, 并再次通过 `.only`发送 你在找污染而不是电线.

如果这两种情况都属于范畴, `root` 捕捉分界线的大小写 是编织者对“相同的血统”的回答:

```ts
if (integrationInstance.root !== extensionInstance.root) {
  throw new Error("fabricator instances are from different lineages");
}
```

它没有抓住分叉 综合案例 移交给扩展, 因为它分享它的根。 当两分之一时 将线接入不同的模块中,这就是这在实践中是如何出错的 在套房里做一个警卫测试: 在两种不同的测试身份下制造同样的计划,并申明 数值不同.

## 所需资源

仅需要Aync堆栈载体用于Aync测试机构,这意味着任何 运行时间 `node:async_hooks` - Bun, Node,和德诺。 此扩展运行 编织器内部的测试块 `wrap`,它拒绝在 浏览器捆绑的同步载体。 一个同步体在这个下 载体也.

## 常见问题

### @ghostry/extern-extension-fabricator-v0 是什么？

@ghostry/ 制造器集成@ghostry/ extern —— 一个由造型器 schema 所建的打出外形块\.

### 如何安装 @ghostry/extern-extension-fabricator-v0？

在项目目录运行 npm install @ghostry/extern-extension-fabricator-v0，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@ghostry/extern（\>=0\.0\.14 \<0\.1\.0）、@ghostry/fabricator（\>=0\.0\.13 \<0\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ghostry/extern-extension-fabricator-v0 支持 TypeScript 吗？

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

### @ghostry/extern-extension-fabricator-v0 支持 ESM 还是 CommonJS？

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

### @ghostry/extern-extension-fabricator-v0 可以商用吗？

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

### @ghostry/extern-extension-fabricator-v0 的下载量有多少？

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

### @ghostry/extern-extension-fabricator-v0 还在维护吗？

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

