跳到主要内容

LocatorAssertions

LocatorAssertions 类提供了断言方法，这些方法可以用于对测试中 Locator 的状态进行断言。

import { test, expect } from '@playwright/test';

test('status becomes submitted', async ({ page }) => {
  // ...
  await page.getByRole('button').click();
  await expect(page.locator('.status')).toHaveText('Submitted');
});

方法​

toBeAttached​

添加于: v1.33 locatorAssertions.toBeAttached

确保 Locator 指向的元素已连接到 Document 或 ShadowRoot。

用法

await expect(page.getByText('Hidden text')).toBeAttached();

参数

  • options Object (可选)

    • attached boolean (可选)#

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeChecked​

添加于: v1.20 locatorAssertions.toBeChecked

确保 Locator 指向一个被选中的 input 元素。

用法

const locator = page.getByLabel('Subscribe to newsletter');
await expect(locator).toBeChecked();

参数

  • options Object (可选)

    • checked boolean (可选)添加于: v1.18#

      提供要断言的状态。默认断言 input 元素为选中状态。当 indeterminate 设置为 true 时，不能使用此选项。

    • indeterminate boolean (可选)添加于: v1.50#

      断言元素处于 indeterminate (混合) 状态。仅支持复选框和单选按钮。当提供 checked 时，此选项不能为 true。

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeDisabled​

添加于: v1.20 locatorAssertions.toBeDisabled

确保 Locator 指向一个禁用的元素。如果元素具有 "disabled" 属性或通过 'aria-disabled' 禁用，则该元素被禁用。请注意，只有原生控件元素（如 HTML button、input、select、textarea、option、optgroup）可以通过设置 "disabled" 属性来禁用。浏览器会忽略其他元素上的 "disabled" 属性。

用法

const locator = page.locator('button.submit');
await expect(locator).toBeDisabled();

参数

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeEditable​

添加于: v1.20 locatorAssertions.toBeEditable

确保 Locator 指向一个可编辑的元素。

用法

const locator = page.getByRole('textbox');
await expect(locator).toBeEditable();

参数

  • options Object (可选)

    • editable boolean (可选)添加于: v1.26#

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeEmpty​

添加于: v1.20 locatorAssertions.toBeEmpty

确保 Locator 指向一个空的、可编辑的元素，或者一个没有文本的 DOM 节点。

用法

const locator = page.locator('div.warning');
await expect(locator).toBeEmpty();

参数

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeEnabled​

添加于: v1.20 locatorAssertions.toBeEnabled

确保 Locator 指向一个启用的元素。

用法

const locator = page.locator('button.submit');
await expect(locator).toBeEnabled();

参数

  • options Object (可选)

    • enabled boolean (可选)添加于: v1.26#

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeFocused​

添加于: v1.20 locatorAssertions.toBeFocused

确保 Locator 指向一个获得焦点的 DOM 节点。

用法

const locator = page.getByRole('textbox');
await expect(locator).toBeFocused();

参数

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeHidden​

添加于: v1.20 locatorAssertions.toBeHidden

确保 Locator 没有解析为任何 DOM 节点，或者解析为一个不可见的节点。

用法

const locator = page.locator('.my-element');
await expect(locator).toBeHidden();

参数

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeInViewport​

添加于: v1.31 locatorAssertions.toBeInViewport

确保 Locator 指向的元素与视口相交，根据 Intersection Observer API。

用法

const locator = page.getByRole('button');
// Make sure at least some part of element intersects viewport.
await expect(locator).toBeInViewport();
// Make sure element is fully outside of viewport.
await expect(locator).not.toBeInViewport();
// Make sure that at least half of the element intersects viewport.
await expect(locator).toBeInViewport({ ratio: 0.5 });

参数

  • options Object (可选)

    • ratio number (可选)#

      元素与视口相交的最小比例。如果等于 0，则元素应以任何正比例与视口相交。默认为 0。

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toBeVisible​

添加于: v1.20 locatorAssertions.toBeVisible

确保 Locator 指向一个已连接且可见的 DOM 节点。

要检查列表中是否至少有一个元素可见，请使用 locator.first()。

用法

// A specific element is visible.
await expect(page.getByText('Welcome')).toBeVisible();

// At least one item in the list is visible.
await expect(page.getByTestId('todo-item').first()).toBeVisible();

// At least one of the two elements is visible, possibly both.
await expect(
    page.getByRole('button', { name: 'Sign in' })
        .or(page.getByRole('button', { name: 'Sign up' }))
        .first()
).toBeVisible();

参数

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

    • visible boolean (可选)添加于: v1.26#

返回

toContainText​

添加于: v1.20 locatorAssertions.toContainText

确保 Locator 指向的元素包含给定的文本。在计算元素的文本内容时，将考虑所有嵌套元素。您也可以对值使用正则表达式。

用法

const locator = page.locator('.title');
await expect(locator).toContainText('substring');
await expect(locator).toContainText(/\d messages/);

如果传递一个数组作为期望值，则期望是

  1. Locator 解析为元素列表。
  2. 此列表的子集中的元素分别包含来自期望数组的文本。
  3. 匹配的元素子集与期望数组具有相同的顺序。
  4. 期望数组中的每个文本值都与列表中的某个元素匹配。

例如，考虑以下列表

<ul>
  <li>Item Text 1</li>
  <li>Item Text 2</li>
  <li>Item Text 3</li>
</ul>

让我们看看如何使用断言

// ✓ Contains the right items in the right order
await expect(page.locator('ul > li')).toContainText(['Text 1', 'Text 3']);

// ✖ Wrong order
await expect(page.locator('ul > li')).toContainText(['Text 3', 'Text 2']);

// ✖ No item contains this text
await expect(page.locator('ul > li')).toContainText(['Some 33']);

// ✖ Locator points to the outer list element, not to the list items
await expect(page.locator('ul')).toContainText(['Text 3']);

参数

  • expected string | RegExp | Array<string | RegExp>添加于: v1.18#

    期望的子字符串或 RegExp 或它们的列表。

  • options Object (可选)

    • ignoreCase boolean (可选)添加于: v1.23#

      是否执行不区分大小写的匹配。ignoreCase 选项优先于指定的相应正则表达式标志。

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

    • useInnerText boolean (可选)添加于: v1.18#

      在检索 DOM 节点文本时，是否使用 element.innerText 而不是 element.textContent。

返回

详情

当 expected 参数是字符串时，Playwright 将在匹配之前规范化实际文本和期望字符串中的空格和换行符。当使用正则表达式时，实际文本将按原样匹配。

toHaveAccessibleDescription​

添加于: v1.44 locatorAssertions.toHaveAccessibleDescription

确保 Locator 指向的元素具有给定的可访问描述。

用法

const locator = page.getByTestId('save-button');
await expect(locator).toHaveAccessibleDescription('Save results to disk');

参数

  • description string | RegExp#

    期望的可访问描述。

  • options Object (可选)

    • ignoreCase boolean (可选)#

      是否执行不区分大小写的匹配。ignoreCase 选项优先于指定的相应正则表达式标志。

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveAccessibleErrorMessage​

添加于: v1.50 locatorAssertions.toHaveAccessibleErrorMessage

确保 Locator 指向的元素具有给定的 aria 错误消息。

用法

const locator = page.getByTestId('username-input');
await expect(locator).toHaveAccessibleErrorMessage('Username is required.');

参数

  • errorMessage string | RegExp#

    期望的可访问错误消息。

  • options Object (可选)

    • ignoreCase boolean (可选)#

      是否执行不区分大小写的匹配。ignoreCase 选项优先于指定的相应正则表达式标志。

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveAccessibleName​

添加于: v1.44 locatorAssertions.toHaveAccessibleName

确保 Locator 指向的元素具有给定的可访问名称。

用法

const locator = page.getByTestId('save-button');
await expect(locator).toHaveAccessibleName('Save to disk');

参数

  • name string | RegExp#

    期望的可访问名称。

  • options Object (可选)

    • ignoreCase boolean (可选)#

      是否执行不区分大小写的匹配。ignoreCase 选项优先于指定的相应正则表达式标志。

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveAttribute(name, value)​

添加于: v1.20 locatorAssertions.toHaveAttribute(name, value)

确保 Locator 指向的元素具有给定属性。

用法

const locator = page.locator('input');
await expect(locator).toHaveAttribute('type', 'text');

参数

  • name string添加于: v1.18#

    属性名称。

  • value string | RegExp添加于: v1.18#

    期望的属性值。

  • options Object (可选)

    • ignoreCase boolean (可选)添加于: v1.40#

      是否执行不区分大小写的匹配。ignoreCase 选项优先于指定的相应正则表达式标志。

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveAttribute(name)​

添加于: v1.39 locatorAssertions.toHaveAttribute(name)

确保 Locator 指向的元素具有给定属性。此方法将断言属性的存在。

const locator = page.locator('input');
// Assert attribute existence.
await expect(locator).toHaveAttribute('disabled');
await expect(locator).not.toHaveAttribute('open');

用法

await expect(locator).toHaveAttribute(name);
await expect(locator).toHaveAttribute(name, options);

参数

  • name string#

    属性名称。

  • options Object (可选)

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveClass​

添加于: v1.20 locatorAssertions.toHaveClass

确保 Locator 指向的元素具有给定的 CSS 类。当提供字符串时，它必须完全匹配元素的 class 属性。要匹配单个类或执行部分匹配，请使用正则表达式

用法

<div class='middle selected row' id='component'></div>
const locator = page.locator('#component');
await expect(locator).toHaveClass('middle selected row');
await expect(locator).toHaveClass(/(^|\s)selected(\s|$)/);

当传递数组时，此方法断言定位到的元素列表与相应的期望类值列表匹配。每个元素的 class 属性都与数组中相应的字符串或正则表达式匹配

const locator = page.locator('list > .component');
await expect(locator).toHaveClass(['component', 'component selected', 'component']);

参数

  • expected string | RegExp | Array<string | RegExp>添加于: v1.18#

    期望的 class 或 RegExp 或它们的列表。

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveCount​

添加于: v1.20 locatorAssertions.toHaveCount

确保 Locator 解析为精确数量的 DOM 节点。

用法

const list = page.locator('list > .component');
await expect(list).toHaveCount(3);

参数

  • count number添加于: v1.18#

    期望的数量。

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveCSS​

添加于: v1.20 locatorAssertions.toHaveCSS

确保 Locator 解析为具有给定计算 CSS 样式的元素。

用法

const locator = page.getByRole('button');
await expect(locator).toHaveCSS('display', 'flex');

参数

  • name string添加于: v1.18#

    CSS 属性名称。

  • value string | RegExp添加于: v1.18#

    CSS 属性值。

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveId​

添加于: v1.20 locatorAssertions.toHaveId

确保 Locator 指向的元素具有给定的 DOM 节点 ID。

用法

const locator = page.getByRole('textbox');
await expect(locator).toHaveId('lastname');

参数

  • id string | RegExp添加于: v1.18#

    元素 id。

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveJSProperty​

添加于: v1.20 locatorAssertions.toHaveJSProperty

确保 Locator 指向的元素具有给定的 JavaScript 属性。请注意，此属性可以是原始类型，也可以是普通的、可序列化的 JavaScript 对象。

用法

const locator = page.locator('.component');
await expect(locator).toHaveJSProperty('loaded', true);

参数

  • name string添加于: v1.18#

    属性名称。

  • value Object添加于: v1.18#

    属性值。

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveRole​

添加于: v1.44 locatorAssertions.toHaveRole

确保 Locator 指向的元素具有给定的 ARIA 角色。

请注意，角色是作为字符串匹配的，忽略了 ARIA 角色层次结构。例如，在具有子类角色 "switch" 的元素上断言超类角色 "checkbox" 将会失败。

用法

const locator = page.getByTestId('save-button');
await expect(locator).toHaveRole('button');

参数

  • role "alert" | "alertdialog" | "application" | "article" | "banner" | "blockquote" | "button" | "caption" | "cell" | "checkbox" | "code" | "columnheader" | "combobox" | "complementary" | "contentinfo" | "definition" | "deletion" | "dialog" | "directory" | "document" | "emphasis" | "feed" | "figure" | "form" | "generic" | "grid" | "gridcell" | "group" | "heading" | "img" | "insertion" | "link" | "list" | "listbox" | "listitem" | "log" | "main" | "marquee" | "math" | "meter" | "menu" | "menubar" | "menuitem" | "menuitemcheckbox" | "menuitemradio" | "navigation" | "none" | "note" | "option" | "paragraph" | "presentation" | "progressbar" | "radio" | "radiogroup" | "region" | "row" | "rowgroup" | "rowheader" | "scrollbar" | "search" | "searchbox" | "separator" | "slider" | "spinbutton" | "status" | "strong" | "subscript" | "superscript" | "switch" | "tab" | "table" | "tablist" | "tabpanel" | "term" | "textbox" | "time" | "timer" | "toolbar" | "tooltip" | "tree" | "treegrid" | "treeitem"#

    必需的 aria 角色。

  • options Object (可选)

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveScreenshot(name)​

添加于: v1.23 locatorAssertions.toHaveScreenshot(name)

此函数将等待直到两次连续的定位器屏幕截图产生相同的结果，然后将最后一次屏幕截图与期望值进行比较。

用法

const locator = page.getByRole('button');
await expect(locator).toHaveScreenshot('image.png');

请注意，屏幕截图断言仅适用于 Playwright 测试运行器。

参数

  • name string | Array<string>#

    快照名称。

  • options Object (可选)

    • animations "disabled" | "allow" (可选)#

      当设置为 "disabled" 时，停止 CSS 动画、CSS 过渡和 Web 动画。动画根据其持续时间获得不同的处理

      • 有限动画会快进到完成状态，因此它们会触发 transitionend 事件。
      • 无限动画会被取消到初始状态，然后在屏幕截图后重新播放。

      默认为 "disabled"，禁用动画。

    • caret "hide" | "initial" (可选)#

      当设置为 "hide" 时，屏幕截图将隐藏文本光标。当设置为 "initial" 时，文本光标行为将不会更改。默认为 "hide"。

    • mask Array<Locator> (可选)#

      指定在截取屏幕截图时应被遮罩的定位器。被遮罩的元素将被粉色框 #FF00FF（可通过 maskColor 自定义）覆盖，该框完全覆盖其边界框。遮罩也应用于不可见元素，请参阅 仅匹配可见元素 以禁用该功能。

    • maskColor string (可选)添加于版本: v1.35#

      指定遮罩元素的覆盖框颜色，采用 CSS 颜色格式。默认颜色为粉色 #FF00FF。

    • maxDiffPixelRatio number (可选)#

      可接受的不同像素与像素总数的比率，介于 0 和 1 之间。默认值可通过 TestConfig.expect 配置。默认未设置。

    • maxDiffPixels number (可选)#

      可接受的不同像素数量。默认值可通过 TestConfig.expect 配置。默认未设置。

    • omitBackground boolean (可选)#

      隐藏默认白色背景，并允许捕获具有透明度的屏幕截图。不适用于 jpeg 图像。默认为 false。

    • scale "css" | "device" (可选)#

      当设置为 "css" 时，屏幕截图将为页面上每个 CSS 像素包含一个像素。对于高 DPI 设备，这将使屏幕截图保持较小。使用 "device" 选项将为每个设备像素生成一个像素，因此高 DPI 设备的屏幕截图将是两倍甚至更大。

      默认为 "css"。

    • stylePath string | Array<string> (可选)添加于版本: v1.41#

      包含在制作屏幕截图时应用的样式表的文件名。您可以在此处隐藏动态元素、使元素不可见或更改其属性，以帮助您创建可重复的屏幕截图。此样式表会穿透 Shadow DOM 并应用于内部框架。

    • threshold number (可选)#

      在 YIQ 色彩空间 中，比较图像中相同像素之间可接受的感知颜色差异，介于零（严格）和一（宽松）之间，默认值可通过 TestConfig.expect 配置。默认为 0.2。

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveScreenshot(options)​

添加于: v1.23 locatorAssertions.toHaveScreenshot(options)

此函数将等待直到两次连续的定位器屏幕截图产生相同的结果，然后将最后一次屏幕截图与期望值进行比较。

用法

const locator = page.getByRole('button');
await expect(locator).toHaveScreenshot();

请注意，屏幕截图断言仅适用于 Playwright 测试运行器。

参数

  • options Object (可选)

    • animations "disabled" | "allow" (可选)#

      当设置为 "disabled" 时，停止 CSS 动画、CSS 过渡和 Web 动画。动画根据其持续时间获得不同的处理

      • 有限动画会快进到完成状态，因此它们会触发 transitionend 事件。
      • 无限动画会被取消到初始状态，然后在屏幕截图后重新播放。

      默认为 "disabled"，禁用动画。

    • caret "hide" | "initial" (可选)#

      当设置为 "hide" 时，屏幕截图将隐藏文本光标。当设置为 "initial" 时，文本光标行为将不会更改。默认为 "hide"。

    • mask Array<Locator> (可选)#

      指定在截取屏幕截图时应被遮罩的定位器。被遮罩的元素将被粉色框 #FF00FF（可通过 maskColor 自定义）覆盖，该框完全覆盖其边界框。遮罩也应用于不可见元素，请参阅 仅匹配可见元素 以禁用该功能。

    • maskColor string (可选)添加于版本: v1.35#

      指定遮罩元素的覆盖框颜色，采用 CSS 颜色格式。默认颜色为粉色 #FF00FF。

    • maxDiffPixelRatio number (可选)#

      可接受的不同像素与像素总数的比率，介于 0 和 1 之间。默认值可通过 TestConfig.expect 配置。默认未设置。

    • maxDiffPixels number (可选)#

      可接受的不同像素数量。默认值可通过 TestConfig.expect 配置。默认未设置。

    • omitBackground boolean (可选)#

      隐藏默认白色背景，并允许捕获具有透明度的屏幕截图。不适用于 jpeg 图像。默认为 false。

    • scale "css" | "device" (可选)#

      当设置为 "css" 时，屏幕截图将为页面上每个 CSS 像素包含一个像素。对于高 DPI 设备，这将使屏幕截图保持较小。使用 "device" 选项将为每个设备像素生成一个像素，因此高 DPI 设备的屏幕截图将是两倍甚至更大。

      默认为 "css"。

    • stylePath string | Array<string> (可选)添加于版本: v1.41#

      包含在制作屏幕截图时应用的样式表的文件名。您可以在此处隐藏动态元素、使元素不可见或更改其属性，以帮助您创建可重复的屏幕截图。此样式表会穿透 Shadow DOM 并应用于内部框架。

    • threshold number (可选)#

      在 YIQ 色彩空间 中，比较图像中相同像素之间可接受的感知颜色差异，介于零（严格）和一（宽松）之间，默认值可通过 TestConfig.expect 配置。默认为 0.2。

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveText​

添加于: v1.20 locatorAssertions.toHaveText

确保 Locator 指向具有给定文本的元素。在计算元素的文本内容时，将考虑所有嵌套元素。您也可以对值使用正则表达式。

用法

const locator = page.locator('.title');
await expect(locator).toHaveText(/Welcome, Test User/);
await expect(locator).toHaveText(/Welcome, .*/);

如果传递一个数组作为期望值，则期望是

  1. Locator 解析为元素列表。
  2. 元素的数量等于数组中预期值的数量。
  3. 列表中的元素具有与预期数组值匹配的文本，一个接一个，按顺序排列。

例如，考虑以下列表

<ul>
  <li>Text 1</li>
  <li>Text 2</li>
  <li>Text 3</li>
</ul>

让我们看看如何使用断言

// ✓ Has the right items in the right order
await expect(page.locator('ul > li')).toHaveText(['Text 1', 'Text 2', 'Text 3']);

// ✖ Wrong order
await expect(page.locator('ul > li')).toHaveText(['Text 3', 'Text 2', 'Text 1']);

// ✖ Last item does not match
await expect(page.locator('ul > li')).toHaveText(['Text 1', 'Text 2', 'Text']);

// ✖ Locator points to the outer list element, not to the list items
await expect(page.locator('ul')).toHaveText(['Text 1', 'Text 2', 'Text 3']);

参数

  • expected string | RegExp | Array<string | RegExp>添加于: v1.18#

    预期的字符串或 RegExp 或它们的列表。

  • options Object (可选)

    • ignoreCase boolean (可选)添加于: v1.23#

      是否执行不区分大小写的匹配。ignoreCase 选项优先于相应的正则表达式标志（如果指定）。

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

    • useInnerText boolean (可选)添加于: v1.18#

      在检索 DOM 节点文本时，是否使用 element.innerText 而不是 element.textContent。

返回

详情

当 expected 参数是字符串时，Playwright 将在匹配之前规范化实际文本和期望字符串中的空格和换行符。当使用正则表达式时，实际文本将按原样匹配。

toHaveValue​

添加于: v1.20 locatorAssertions.toHaveValue

确保 Locator 指向具有给定输入值的元素。您也可以对值使用正则表达式。

用法

const locator = page.locator('input[type=number]');
await expect(locator).toHaveValue(/[0-9]/);

参数

  • value string | RegExp添加于: v1.18#

    预期值。

  • options Object (可选)

    • timeout number (可选)添加于: v1.18#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toHaveValues​

添加于: v1.23 locatorAssertions.toHaveValues

确保 Locator 指向多选/组合框（即具有 multiple 属性的 select），并且已选择指定的值。

用法

例如，给定以下元素

<select id="favorite-colors" multiple>
  <option value="R">Red</option>
  <option value="G">Green</option>
  <option value="B">Blue</option>
</select>
const locator = page.locator('id=favorite-colors');
await locator.selectOption(['R', 'G']);
await expect(locator).toHaveValues([/R/, /G/]);

参数

  • values Array<string | RegExp>#

    当前选定的预期选项。

  • options Object (可选)

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toMatchAriaSnapshot(expected)​

添加于版本: v1.49 locatorAssertions.toMatchAriaSnapshot(expected)

断言目标元素与给定的可访问性快照匹配。

用法

await page.goto('https://demo.playwright.dev/todomvc/');
await expect(page.locator('body')).toMatchAriaSnapshot(`
  - heading "todos"
  - textbox "What needs to be done?"
`);

参数

  • expected string#
  • options Object (可选)

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

toMatchAriaSnapshot(options)​

添加于: v1.50 locatorAssertions.toMatchAriaSnapshot(options)

断言目标元素与给定的可访问性快照匹配。

快照存储在单独的 .aria.yml 文件中，位置由配置文件中的 expect.toMatchAriaSnapshot.pathTemplate 和/或 snapshotPathTemplate 属性配置。

用法

await expect(page.locator('body')).toMatchAriaSnapshot();
await expect(page.locator('body')).toMatchAriaSnapshot({ name: 'body.aria.yml' });

参数

  • options Object (可选)

    • name string (可选)#

      要存储在与此测试对应的快照文件夹中的快照名称。如果未指定，则生成顺序名称。

    • timeout number (可选)#

      重试断言的超时时间，以毫秒为单位。默认为 TestConfig.expect 中的 timeout。

返回

属性​

not​

添加于: v1.20 locatorAssertions.not

使断言检查相反的条件。例如，此代码测试 Locator 不包含文本 "error"

await expect(locator).not.toContainText('error');

用法

expect(locator).not

类型