鸡尾酒
说明: 用户端 API 的更多细节可见于 最佳文档。 。 。 .
API 密码
import {ModuleMocker} from 'jest-mock';
constructor(global)
创建一个新的模块模拟器,生成模拟器,仿佛它们是在与给定的全局对象一起的环境里创建的.
generateFromMetadata(metadata)
基于给定的元数据生成一个模拟( 用于模拟的元数据 ) getMetadata() 本单元的方法)。 模拟函数特别处理函数,所有模拟函数都有额外的成员,在文档中描述 fn() 本单元中.
一个重要的注意:功能原型由这个嘲弄框架专门处理. 对于有原型的功能,被叫作构造器时,模型会以实例安装被模拟的功能成员. 这允许同一构造器的不同实例对其模拟成员及其返回值具有不同的值.
getMetadata(component)
检查参数,并以下列递归格式返回其方案:
{
type: ...
members: {}
}
类型之一 array, (中文(简体) ), object, (中文(简体) ), function,或 ref,而成员是一个可选词典,其中密钥为成员名而值为元数据对象. 函数原型通过定义元数据定义 member.prototype 函数。 函数原型的型号应该总是 object例如,一个类别可以这样定义:
const classDef = {
type: 'function',
members: {
staticMethod: {type: 'function'},
prototype: {
type: 'object',
members: {
instanceMethod: {type: 'function'},
},
},
},
};
元数据也可能包含对同一元数据对象所定义的其他对象的引用. 参考方的元数据必须标明 refID 键和任意值。 裁判员必须用 ref 键,其值与它所指的重置ID对象相同。 例如,这个元数据blob:
const refID = {
type: 'object',
refID: 1,
members: {
self: {ref: 1},
},
};
定义带有槽的对象 self 指的是对象.
fn(implementation?)
与帮助驱动单位测试或确认预期的成员生成独立的功能. 具体地说,通过这种方法返回的职能成员如下:
.mock
有三名成员的天体, calls, (中文(简体) ), instances 财务报告和审定财务报表 invocationCallOrder,这些都是列表。 二、《公约》项目 calls 列表是函数被调用的参数。 "Intances"列表存储每个调用函数的"This"值. 这对于从构建者那里获取实例是有用的 。 这个 invocationCallOrder 从 1 开始, 列出模拟调用所有模拟调用的顺序 .
.mockReturnValueOnce(value)
将给定值推入函数返回值的 FIFO 队列.
.mockReturnValue(value)
设置函数的默认返回值.
.mockImplementationOnce(function)
将给定的模拟执行推入函数模拟执行的 FIFO 队列.
.mockImplementation(function)
设置函数的默认模拟执行.
.mockReturnThis()
用于:
mockFn.mockImplementation(function () {
return this;
});
以防两者皆有 .mockImplementationOnce() 编号 : .mockImplementation() 财务报告和审定财务报表 .mockReturnValueOnce() 编号 : .mockReturnValue() 被调用。 优先使用的依据是最后的呼叫:
- 如果最后的电话是
.mockReturnValueOnce()或者说.mockReturnValue(),使用特定返回值或默认返回值。 如果使用特定返回值, 或者没有设置默认返回值, 请倒回尝试.mockImplementation()· ; - 如果最后的电话是
.mockImplementationOnce()或者说.mockImplementation(),运行特定执行并返回结果或运行默认执行并返回结果.
.withImplementation(function, callback)
暂时地在回调中推翻了默认的模拟执行,再恢复之前的执行.
如果回调为 Aync 或返回 a thenable, (中文(简体) ), withImplementation 将返回一个承诺。 等待承诺将等待召回并重新确定执行.