Cypress应用

title

获取当前活动页面的 document.title 属性。

语法

cy.title()
cy.title(options)

用法

正确用法

cy.title() // 以字符串形式返回文档标题

参数

options (Object)

传入一个选项对象来改变 cy.title() 的默认行为。

选项	默认值	描述
log	true	在命令日志中显示该命令
timeout	defaultCommandTimeout	在超时前等待 cy.title() 解析的时间

生成结果

• cy.title() 返回当前页面的 document.title 属性。
• cy.title() 是一个查询命令，可以安全地链式调用其他命令。

示例

无参数

断言文档标题为 "My Awesome Application"

cy.title().should('eq', 'My Awesome Application')

规则

要求

• cy.title() 必须通过 cy 链式调用。

断言

• cy.title() 会自动重试，直到所有链式断言通过。

超时设置

• cy.title() 可能会因等待添加的断言通过而超时。

命令日志

断言文档标题包含 'New User'

cy.title().should('include', 'New User')

以上命令将在命令日志中显示为：

当点击命令日志中的 title 时，控制台会输出以下内容：

历史

版本	变更
< 0.3.3	添加了 cy.title() 命令

另请参阅

• cy.document()