# @ghostry/fabricator-extension-faker-v10 中文文档

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

版本：0\.0\.3
npm 元数据更新时间：2026-11-09T02:40:07.360Z
中文译文更新时间：2026-11-16T14:17:31.811Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：98.7 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：0 个
- peer 依赖：@faker-js/faker ^10\.5\.0，@ghostry/fabricator \>=0\.0\.14 \<0\.1\.0
- 首次发布：2026-08-23T19:38:53.969Z
- 最新版本发布：2026-11-09T02:40:07.027Z
- 近 30 天下载量：2044（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

@faker-js/faker集成为@ghostry/fabricator——假冒者的数据生成器,通过调用它们的编织器实例来播种和再生.

## 安装

```sh
npm install @ghostry/fabricator-extension-faker-v10
```

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

## README

![fabricator](https://docs.ghostry.dev/fabricator/logo.png)

# @ghostry/ 制造器- 扩展- faker- v10

**种子假冒发电机 `@ghostry/fabricator`。 。 。 .**

[![npm](https://img.shields.io/badge/npm-ffffff.svg?style=for-the-badge&color=000000&logo=npm&logoColor=CB3837)](https://www.npmjs.com/package/@ghostry/fabricator-extension-faker-v10) [![npmx](https://img.shields.io/badge/npmx-ffffff.svg?style=for-the-badge&color=000000&logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNTMiIGhlaWdodD0iMTUzIiB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCAxNTMgMTUzIj4KICA8ZyB0cmFuc2Zvcm09InRyYW5zbGF0ZSgxNi43MDQgOS45ODI3KSI+CiAgICA8cGF0aCBkPSJtMC45MzQ3NiA5Ny4yMDVoMjQuMDgxdjIzLjY5M2gtMjQuMDgxeiIgZmlsbD0iI2ZmZiI+PC9wYXRoPgogICAgPHBhdGggZD0ibTEwMy4xMi05LjIzMDctMy42MjExIDEwLjI0Ni00Ni4zMDkgMTMxLTMuNjIxMSAxMC4yNDZoMTUuNTM3bDMuNjIxMS0xMC4yNDYgMTEuNzE3LTMzLjE0OCAzOC4yMTEtMTA4LjF6IiBmaWxsPSIjNTFjOGZjIj48L3BhdGg+CiAgPC9nPgo8L3N2Zz4K&logoColor=51C8FC)](https://npmx.dev/package/@ghostry/fabricator-extension-faker-v10) [![jsr](https://img.shields.io/badge/jsr-ffffff?style=for-the-badge&color=000000&logo=jsr&logoColor=F7DF1E)](https://jsr.io/@ghostry/fabricator-extension-faker-v10) [![github](https://img.shields.io/badge/github-ffffff?style=for-the-badge&color=000000&logo=github&logoColor=ffffff)](https://github.com/ghostry-dev/fabricator) [![typescript](https://img.shields.io/badge/typescript-ffffff?style=for-the-badge&color=000000&logo=typescript&logoColor=3178C6)](https://npmcn.com/package/%40ghostry/fabricator-extension-faker-v10/#) [![bun](https://img.shields.io/badge/bun-ffffff?style=for-the-badge&color=000000&logo=bun&logoColor=FBF0DF)](https://npmcn.com/package/%40ghostry/fabricator-extension-faker-v10/#) [![node](https://img.shields.io/badge/node-ffffff?style=for-the-badge&color=000000&logo=nodedotjs&logoColor=5FA04E)](https://npmcn.com/package/%40ghostry/fabricator-extension-faker-v10/#)

[`@faker-js/faker`](https://fakerjs.dev/) 合并 [`@ghostry/fabricator`](https://www.npmjs.com/package/@ghostry/fabricator)Faker的发电机和所有建筑工一样 都来自同一个溪流 `T.faker.person.fullName()` 重放完全一样 `T.string` 执行 —— 没有额外的跟踪, 没有运行之间的漂移 .

目标 `@faker-js/faker` 10.x 具体——因此 `-v10` 后缀,匹配适配软件包的会话. 未来的假冒者主修是具有自己同级范围的同级软件包,而不是这个软件的版本起伏.

## 安装

```bash
npm install @ghostry/fabricator-extension-faker-v10 @ghostry/fabricator @faker-js/faker
```

`@ghostry/fabricator` 财务报告和审定财务报表 `@faker-js/faker` 是同伴的依赖关系——带来你自己的.

## 示例

`fakerExtension` 返回 a `registry.extend` 回话,所以假造者 的建设者到达作为 `T.faker.*` 在普通的扩展登记册上,与每一种核心类型一起:

```ts
import { en } from "@faker-js/faker";
import { initialize, registry } from "@ghostry/fabricator";
import { fakerExtension } from "@ghostry/fabricator-extension-faker-v10";

const { T, Fabricator } = initialize({
  types: registry.extend(fakerExtension({ locale: en })),
});

const UserSchema = T.object({
  name: T.faker.person.fullName(),
  email: T.faker.internet.email(),
  joined: T.faker.date.past(),
  id: T.string.whereby({ length: { max: 8 } }),
});

new Fabricator(UserSchema).fabricate();
```

`locale` 取假人自己的地语定义,而不是一个地语名称,确切的说 `new Faker({ locale })` —— 导入您使用的部件时, 其余部分不要装入包中.

Faker的相对日期方法解决了同一案件 `clock` 那个 `T.date.past`编号 :`T.date.future` 做 —— 两人对"现在"是什么在一种计划内,从不持不同意见.

## 每个建筑师都是真正的人,从不 `opaque`

假冒方法本来可以被包裹成不透明的生产者,而这是这个软件包拒绝做的一件事——一种 `opaque` 计划转换为 `Type.Unknown()` 在任何适配器中,且不可见 `combinatorial`编号 :`coverage`。每个构建者返回匹配方法自身返回类型的核心类型:

| 假冒者返回 | 构建器返回 | 通过 TypeBox 适配器 |
| --- | --- | --- |
| `string` (207) (中文(简体) ) | `T.string` | `Type.String()` |
| `Date` (7个) | `T.date` | `Type.Date()` |
| 记录形状(7) | `T.object({ ... })` | `Type.Object({ ... })` |
| 字面结合(6) | `T.enum.uniform([...])` | `Type.Union([Type.Literal(), …])` |
| `number` (6个) | `T.number` | `Type.Number()` |
| `boolean` (1) 国家 | `T.boolean` | `Type.Boolean()` |
| `bigint` (1) 国家 | `T.bigint` | `Type.BigInt()` |
| `[number, number]` (1) 国家 | `T.tuple([T.number, T.number])` | `Type.Tuple([Type.Number(), Type.Number()])` |
| `Date[]` (1) 国家 | `T.array(T.date)` | `Type.Array(Type.Date())` |

17个字符串方法,其输出满足JSON-Schema格式,而不论通过何种选项,都额外携带—— `internet.email()` 转换为 `Type.String({ format: "email" })`, (中文(简体) ), `database.mongodbObjectId()` 改为 `pattern`。 。 。 .

镜像由手写而成,没有生成——每个构建者一个声明和一个执行,由编译者一致保存. 编译时间断言对照假冒者自己申报的返回类型检查每个条目的值类型,所以假冒者发布更改一个失败 `tsc` 而不是无声地放出错误的计谋.

## 假冒者自己的API的三次偏差

镜不是1:1,每次出站都使得上面的保证成为可能.

**`helpers` 缺席.** 它是一个功能带,而不是一个数据模块,核心已经更好地表达它的全部: `arrayElement` 实值 `T.enum.uniform(...)`, (中文(简体) ), `arrayElements`编号 :`multiple` 为: `T.array(...).whereby({ length })`, (中文(简体) ), `maybe` 实值 `T.optional`编号 :`T.omittable`, (中文(简体) ), `rangeToNumber` 实值 `T.number.whereby({ min, max })`其18个方法中的11个是通用的,将消除到 `unknown`在没有核心等同物的情况下与两者接触 -- `fromRegExp` 财务报告和审定财务报表 `fake` 通过 `use`页:1.

**七个 `color.*` 返回类型取决于其参数的方法被一分为二.** `color.rgb()` 返回 a `string` 或一个 `number[]` 取决于 `options.format`,没有任何一种可以诚实地描述,所以每个都成为两个有名的建筑商的命名空间——并且刻意没有赤裸的 `T.faker.color.rgb()`数字 :

```ts
T.faker.color.rgb.text(); // T.string
T.faker.color.rgb.channels(); // T.array(T.number)
T.faker.color.rgb.channels({ includeAlpha: true });
```

这同样适用于 `cmyk`, (中文(简体) ), `hsl`, (中文(简体) ), `hwb`, (中文(简体) ), `lab`, (中文(简体) ), `lch`,以及 `colorByCSSColorSpace`。 。 。 . `color`其他四种方法是普通的建造者.

**假冒者申报的返回类型比JS类型要窄的地方,这种类型与之相去甚远.** 字面结合成为 `enum`,而不是一个 `string`数字 : `person.sexType()` 给 `T.enum.uniform(["female", "generic", "male"])`,因此它转换成一成一成一成一成一成一成一成一成一成一成一成二成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成一成 `combinatorial`编号 :`coverage` 而不是一个不受约束的字符串。 固定值数组成为 `tuple`,而不是一个 `array`数字 : `location.nearbyGPSCoordinate()` 给 `T.tuple([T.number, T.number])`,因为任何选择都无法改变 `[latitude, longitude]` 平等性——不同于上面的彩色通道,这就是为什么那些留在 `T.array`。 。 。 .

## `use` 因为镜子没有覆盖

`use` 给您分享,流回 `Faker` 在制片人体内,通过它得到的任何东西 仍然取自叶子本身的种子流。 它是一个简单的名称空间,有种标记的形式——你说什么形状会回来,并保留一种真正的:

```ts
T.faker.use.string((f) => f.helpers.fromRegExp("[A-Z]{3}-[0-9]{4}"));
T.faker.use.string((f) =>
  f.helpers.fake("{{person.firstName}} {{person.lastName}}"),
);
T.faker.use.number((f) => f.helpers.rangeToNumber({ min: 1, max: 10 }));
T.faker.use.opaque((f) => f.helpers.arrayElement(["free", "pro"] as const));
```

`use.string`, (中文(简体) ), `.number`, (中文(简体) ), `.date`, (中文(简体) ), `.boolean`,以及 `.bigint` 保持适配器兼容. `use.opaque` 这是获得一个 `opaque` 从这个包里出来——诚实地说,因为这是你没有告诉它形状的一个例子.

## 页:1

`faker.seed(...)` 从设计上来说,它是惰性的: 编织者的播种管理, 而第二个竞争控制相同输出的是 这个包存在的bug。 改变实例 `clock` ——或 `salt`如果它有一个——相反.

外面有个建筑师 `fabricate()` 掷出 `FakerExtensionError.NoActiveScopeError` ——没有从中提取的积极捏造. `FakerExtensionError` 扩展核心 `FabricatorError`,所以一个 `catch` 仍然覆盖两个包裹.

见 [伪造指南](https://docs.ghostry.dev/fabricator/guides/faker) 和工作实例.

## 常见问题

### @ghostry/fabricator-extension-faker-v10 是什么？

@faker-js/faker集成为@ghostry/fabricator——假冒者的数据生成器,通过调用它们的编织器实例来播种和再生\.

### 如何安装 @ghostry/fabricator-extension-faker-v10？

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

### @ghostry/fabricator-extension-faker-v10 支持 TypeScript 吗？

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

### @ghostry/fabricator-extension-faker-v10 支持 ESM 还是 CommonJS？

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

### @ghostry/fabricator-extension-faker-v10 需要什么版本的 Node\.js？

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

### @ghostry/fabricator-extension-faker-v10 可以商用吗？

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

### @ghostry/fabricator-extension-faker-v10 的下载量有多少？

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

### @ghostry/fabricator-extension-faker-v10 还在维护吗？

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

