@faker-js/faker 合并 @ghostry/fabricatorFaker的发电机和所有建筑工一样 都来自同一个溪流 T.faker.person.fullName() 重放完全一样 T.string 执行 —— 没有额外的跟踪, 没有运行之间的漂移 .
目标 @faker-js/faker 10.x 具体——因此 -v10 后缀,匹配适配软件包的会话. 未来的假冒者主修是具有自己同级范围的同级软件包,而不是这个软件的版本起伏.
安装
npm install @ghostry/fabricator-extension-faker-v10 @ghostry/fabricator @faker-js/faker
@ghostry/fabricator 财务报告和审定财务报表 @faker-js/faker 是同伴的依赖关系——带来你自己的.
示例
fakerExtension 返回 a registry.extend 回话,所以假造者 的建设者到达作为 T.faker.* 在普通的扩展登记册上,与每一种核心类型一起:
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()数字 :
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 在制片人体内,通过它得到的任何东西 仍然取自叶子本身的种子流。 它是一个简单的名称空间,有种标记的形式——你说什么形状会回来,并保留一种真正的:
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 仍然覆盖两个包裹.
见 伪造指南 和工作实例.