测试 Kibana 插件
了解推荐的测试方法。
核心服务已经提供模拟,以简化测试并确保插件始终依赖有效的公共合同
my_plugin/server/plugin.test.ts
import { configServiceMock } from '@kbn/core/server/mocks';
const configService = configServiceMock.create();
configService.atPath.mockReturnValue(config$);
…
const plugin = new MyPlugin({ configService }, …);
或者,如果您需要获取整个核心 setup
或 start
合同
my_plugin/server/plugin.test.ts
import { coreMock } from '@kbn/core/public/mocks';
const coreSetup = coreMock.createSetup();
coreSetup.uiSettings.get.mockImplementation((key: string) => {
…
});
…
const plugin = new MyPlugin(coreSetup, ...);
虽然这不是强制性的,但我们强烈建议您也导出您的插件模拟,以便依赖插件在测试中使用它们。 您的插件模拟应该从插件的根目录 /server
和 /public
目录导出
my_plugin/(server|public)/mocks.ts
const createSetupContractMock = () => {
const startContract: jest.Mocked<MyPluginStartContract>= {
isValid: jest.fn(),
}
// here we already type check as TS infers to the correct type declared above
startContract.isValid.mockReturnValue(true);
return startContract;
}
export const myPluginMocks = {
createSetup: createSetupContractMock,
createStart: …
}
插件模拟应仅包含公共 API的模拟:setup
、start
和 stop
合同。 对于纯函数,模拟不是必需的,因为其他插件可以在测试中调用原始实现。