跳到主要内容

使用 API

@grafana/plugin-e2e 包使用 页面对象模型 模式来简化测试的编写并 облегчить 代码库的维护。在页面对象模型中，应用程序的每个网页都表示为一个类文件。

类​

在 @grafana/plugin-e2e 包中，类表示 Grafana 中的页面或组件。它们的目的是在一个地方封装常见的 UI 操作。它们还处理不同 Grafana 版本之间的 UI 偏差。

该包导出类，但这些类也通过 Playwright API 通过所谓的 fixtures 公开。

Fixtures​

@grafana/plugin-e2e 包定义了一组 自定义 fixtures，以方便 Grafana 插件的端到端测试。

以下部分解释了不同类型的页面 fixtures

页面​

页面模型对象可以表示页面的新实例或已存在资源的页面。要查看 @grafana/plugin-e2e 公开的页面的完整列表，请参阅 Github 存储库。

在测试中使用页面类型的新空实例​

要在某种类型的新空页面中开始测试，请使用页面对象模型名称的驼峰式表示法。

以下示例使用变量编辑页面。当使用 variableEditPage fixture 时，测试将从新仪表板中的空变量编辑表单开始。

test('test variable edit page', async ({ variableEditPage }) => {
  await variableEditPage.setVariableType('Query');
});

使用现有资源​

要使用指向已存在资源的页面对象模型开始测试，请使用任何以 goto 为前缀的 fixtures。

以下示例使用 gotoAnnotationEditPage fixture 来解析 AnnotationEditPage 模型。调用此 fixture 将导航到现有仪表板中现有注释的编辑表单。

test('test annotation query', async ({ gotoAnnotationEditPage }) => {
  const annotationEditPage = await gotoAnnotationEditPage({ dashboard: { uid: 'trlxrdZVk' }, id: '1' });
  await expect(annotationEditPage.runQuery()).toBeOK();
});

要了解如何使用您需要的资源配置 Grafana 实例，请参阅设置资源指南。

Expect matchers​

Playwright API 允许您通过提供自定义 matchers 来扩展默认断言。@grafana/plugin-e2e 定义了一组自定义 matchers，用于简化某些页面的断言。要查看 matchers 的完整列表，请参阅 Github 存储库。