确保 API

概述

从 Nightwatch 2.0 开始，新的 .ensure API 映射了现有的 Selenium until 模块。

它的工作原理类似于现有的 .assert 库，并提供了大部分相同的功能，但它可能会提供额外的灵活性。对于已经使用 Selenium 的 until API 的用户来说，它也可能更熟悉。

基本示例
describe('demo test for .ensure', function() {
  

  it('basic test', function(browser) {
    browser
      .url('https://nightwatch.node.org.cn')
      .ensure.titleMatches(/Nightwatch\.js/)
      .ensure.elementIsVisible('#index-container')  
  });
});

可用断言

.ableToSwitchToFrame(frame)

确保 Nightwatch WebDriver 客户端能够切换到指定的框架。

参数
名称 类型 描述
frame Number|WebElement|By 框架标识符。

.alertIsPresent()

创建一个条件，等待警报打开。

参数
无

.elementIsDisabled(element)

创建一个条件，等待给定的元素被禁用。

参数
名称 类型 描述
元素 WebElement 要测试的元素。

.elementIsEnabled(element)

创建一个条件，等待给定的元素被启用。

参数
名称 类型 描述
元素 WebElement 要测试的元素。

.elementIsNotSelected(element)

创建一个条件，等待给定的元素被取消选择。

参数
名称 类型 描述
元素 WebElement 要测试的元素。

.elementIsNotVisible(element)

创建一个条件，等待给定的元素在 DOM 中，但未显示给用户。

参数
名称 类型 描述
元素 WebElement 要测试的元素。

.elementIsNotVisible(element)

创建一个条件，等待给定的元素在 DOM 中，但未显示给用户。

参数
名称 类型 描述
元素 WebElement 要测试的元素。

.elementIsSelected(element)

创建一个条件，等待给定的元素被选中。

参数
名称 类型 描述
元素 WebElement 要测试的元素。

.elementIsVisible(element)

创建一个条件，等待给定的元素被显示。

参数
名称 类型 描述
元素 WebElement 要测试的元素。

.elementLocated(locator)

创建一个条件，循环直到找到具有给定定位器的元素。

参数
名称 类型 描述
定位器 By 要使用的定位器。

.elementTextContains(element, substr)

创建一个条件，等待给定元素的文本包含给定的子字符串。

参数
名称 类型 描述
元素 WebElement 要测试的元素。
子字符串 String 要搜索的子字符串。

.elementTextIs(element, text)

创建一个条件，等待给定元素的文本等于给定的文本。

参数
名称 类型 描述
元素 WebElement 要测试的元素。
文本 String 预期的文本。

.elementTextMatches(element, regex)

创建一个条件，等待给定元素的文本与给定的正则表达式匹配。

参数
名称 类型 描述
元素 WebElement 要测试的元素。
正则表达式 RegExp 要测试的正则表达式。

.elementsLocated(locator)

创建一个条件，循环直到找到至少一个具有给定定位器的元素。

参数
名称 类型 描述
定位器 By 要使用的定位器。

.stalenessOf(element)

创建一个条件，等待给定的元素变得陈旧。当元素从 DOM 中删除或加载了新页面时，元素被认为是陈旧的。

参数
名称 类型 描述
元素 WebElement 应该变得陈旧的元素。

.titleContains(substr)

创建一个条件，等待当前页面的标题包含给定的子字符串。

参数
名称 类型 描述
子字符串 String 应该出现在页面标题中的子字符串。

.titleIs(substr)

创建一个条件，等待当前页面的标题与给定的值匹配。

参数
名称 类型 描述
子字符串 String 预期的页面标题。

.titleMatches(regex)

创建一个条件，等待当前页面的标题与给定的正则表达式匹配。

参数
名称 类型 描述
正则表达式 RegExp 要测试的正则表达式。

.urlContains(substrUrl)

创建一个条件，等待当前页面的 URL 包含给定的子字符串。

参数
名称 类型 描述
子字符串 URL String 应该出现在当前 URL 中的子字符串。

.urlIs(url)

创建一个条件，等待当前页面的 URL 与给定的值匹配。

参数
名称 类型 描述
子字符串 URL String 预期的页面 URL。

.urlMatches(regex)

创建一个条件，等待当前页面的 URL 与给定的正则表达式匹配。

参数
名称 类型 描述
正则表达式 RegExp 要测试的正则表达式。