发布说明

更改内容

• 修复 selectElement 示例测试。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4233 中完成
• 更新 ws 依赖项。由 @AutomatedTester 在 https://github.com/nightwatchjs/nightwatch/pull/4235 中完成
• 添加 .check 和 .uncheck 命令以进行不可变的复选框操作。由 @reallymello 在 https://github.com/nightwatchjs/nightwatch/pull/4232 中完成

**完整变更日志**: https://github.com/nightwatchjs/nightwatch/compare/v3.6.4...v3.7.0

更改内容

• 修复 Cucumber 中的错误，当会话在测试用例本身中关闭时。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4209 中完成
• 修复 API 文档中的页面对象演示示例。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4210 中完成
• 修复 API 文档中的 W3C WebDriver Spec 链接。由 @Halim-Shams 在 https://github.com/nightwatchjs/nightwatch/pull/4166 中完成
• 对 API 文档中更新值的少量修改。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4213 中完成
• 修复 setPassword 命令的 API 文档。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4225 中完成
• 修复 API 文档中的选择器对象文档链接。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4226 中完成
• 允许从暂停命令进入 DEBUG 模式。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4224 中完成

新贡献者

• @Halim-Shams 在 https://github.com/nightwatchjs/nightwatch/pull/4166 中做出了他们的第一个贡献

**完整变更日志**: https://github.com/nightwatchjs/nightwatch/compare/v3.6.3...v3.6.4

更改内容

• 将 selenium-webdriver 提升到 4.21.0。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4207 中完成

**完整变更日志**: https://github.com/nightwatchjs/nightwatch/compare/v3.6.2...v3.6.3

更改内容

修复

• 修复报告器中命令参数显示为 '[object Object]'。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4195 中完成
• 修复当使用 async/await 时 waitFor 命令导致测试无法中止的问题。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4196 中完成

依赖项更新

• 将 ejs 提升到 3.1.10。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4204 中完成
• chore: 将 mocha 从 10.2.0 提升到 10.3.0 以删除 CVE-2022-3517。由 @athammer 在 https://github.com/nightwatchjs/nightwatch/pull/4199 中完成
• 将 selenium-webdriver 提升到 4.20.0。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4206 中完成

新贡献者

• @athammer 在 https://github.com/nightwatchjs/nightwatch/pull/4199 中做出了他们的第一个贡献

**完整变更日志**: https://github.com/nightwatchjs/nightwatch/compare/v3.6.1...v3.6.2

更改内容

增强功能

• 为 clear 命令添加回退。由 @FireNdIce3 在 https://github.com/nightwatchjs/nightwatch/pull/4035 中完成（这也影响了 setValue 和 updateValue 命令，它们会在发送新值之前清除字段。）
• 在新的 Element API 中，当元素未找到时使用 NoSuchElementError。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4193 中完成

修复

• 修复 debug() 仅允许在 async/await 模式下运行一个命令的问题。由 @chikara1608 在 https://github.com/nightwatchjs/nightwatch/pull/4139 中完成
• 修复 iOS 错误的帮助消息。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4189 中完成
• 为 NoSuchElementError 保留错误的原始消息。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4191 中完成
• 更新页面对象测试以确保无效的页面对象元素由 @AutomatedTester 处理。由 @AutomatedTester 在 https://github.com/nightwatchjs/nightwatch/pull/4187 中完成

在新的 Element API 中添加别名（为了向后兼容）

• .ariaRole() 作为 .getAriaRole() 的别名。由 @Sajantoor 在 https://github.com/nightwatchjs/nightwatch/pull/4159 中完成
• .text() 作为 .getText() 的别名。由 @Ayush-Vish 在 https://github.com/nightwatchjs/nightwatch/pull/4180 中完成
• .prop() 作为 .getProperty() 的别名。由 @Ayush-Vish 在 https://github.com/nightwatchjs/nightwatch/pull/4174 中完成
• .accessibleName() 作为 .getAccessibleName() 的别名。由 @Ayush-Vish 在 https://github.com/nightwatchjs/nightwatch/pull/4178 中完成
• .tagname() 作为 .getTagName() 的别名。由 @Ayush-Vish 在 https://github.com/nightwatchjs/nightwatch/pull/4176 中完成
• .css() 和 .getCssValue() 作为 .getCssProperty() 的别名。由 @Ayush-Vish 在 https://github.com/nightwatchjs/nightwatch/pull/4168 中完成
• .attr() 和 .attribute() 作为 .getAttribute() 的别名。由 @Ayush-Vish 在 https://github.com/nightwatchjs/nightwatch/pull/4172 中完成
• 在新的 Element API 中为 .find() 和 .findAll() 命令添加别名。由 @AritraLeo 在 https://github.com/nightwatchjs/nightwatch/pull/4130 中完成

新贡献者

• @Sajantoor 在 https://github.com/nightwatchjs/nightwatch/pull/4159 中做出了他们的第一个贡献
• @Ayush-Vish 在 https://github.com/nightwatchjs/nightwatch/pull/4180 中做出了他们的第一个贡献
• @AritraLeo 在 https://github.com/nightwatchjs/nightwatch/pull/4130 中做出了他们的第一个贡献
• @FireNdIce3 在 https://github.com/nightwatchjs/nightwatch/pull/4035 中做出了他们的第一个贡献

**完整变更日志**: https://github.com/nightwatchjs/nightwatch/compare/v3.6.0...v3.6.1

更改内容

• 添加 rect() 作为 getRect() 命令的别名。由 @dikwickley 在 https://github.com/nightwatchjs/nightwatch/pull/4128 中完成
• 修复 waitUntil 在 async/await 中无法正常工作的问题。由 @chikara1608 在 https://github.com/nightwatchjs/nightwatch/pull/4123 中完成
• 修复当 waitUntil 抛出错误时导致测试中止的错误。#4157。由 @chikara1608 在 https://github.com/nightwatchjs/nightwatch/pull/4161 中完成

新贡献者

• @chikara1608 在 https://github.com/nightwatchjs/nightwatch/pull/4123 中做出了他们的第一个贡献

**完整变更日志**: https://github.com/nightwatchjs/nightwatch/compare/v3.5.0...v3.6.0

更改内容

• 为 TimeoutError 在钩子中的添加可操作的错误消息。由 @dikwickley 在 https://github.com/nightwatchjs/nightwatch/pull/4053 中完成
• 将缺少的 isSelected 命令添加到新的 Element API。由 @dikwickley 在 https://github.com/nightwatchjs/nightwatch/pull/4038 中完成
• 将缺少的 isEnabled 命令添加到新的 Element API。由 @subhajit20 在 https://github.com/nightwatchjs/nightwatch/pull/4041 中完成
• 重构 README 中的命令。由 @konavivekramakrishna 在 https://github.com/nightwatchjs/nightwatch/pull/4076 中完成
• 从原始 HTTP 日志中隐藏密码值。由 @dikwickley 在 https://github.com/nightwatchjs/nightwatch/pull/4066 中完成
• 修复 getText 命令的 JSDoc 示例。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/4043 中完成
• 将缺少的 isVisible 命令添加到新的 Element API。由 @subhajit20 在 https://github.com/nightwatchjs/nightwatch/pull/4039 中完成
• 将 isDisplayed() 作为 isVisible() 的别名添加。由 @uditrajput03 在 https://github.com/nightwatchjs/nightwatch/pull/4107 中完成
• 修复 takeScreenshot 示例。由 @dikwickley 在 https://github.com/nightwatchjs/nightwatch/pull/4121 中完成
• 允许使用 cucumber 进行并行环境。由 @AutomatedTester 在 https://github.com/nightwatchjs/nightwatch/pull/4095 中完成

新贡献者

• @dikwickley 在 https://github.com/nightwatchjs/nightwatch/pull/4053 中做出了他们的第一次贡献。
• @subhajit20 在 https://github.com/nightwatchjs/nightwatch/pull/4041 中做出了他们的第一次贡献。
• @konavivekramakrishna 在 https://github.com/nightwatchjs/nightwatch/pull/4076 中做出了他们的第一次贡献。
• @uditrajput03 在 https://github.com/nightwatchjs/nightwatch/pull/4107 中做出了他们的第一次贡献。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.4.1...v3.5.0

更改内容

• 警告单个测试套件中的两个 describe()。由 @garg3133 在 #4011 中提交。
• 使用 Ctrl+C 退出 Nightwatch 时修复错误。由 @garg3133 在 #4013 中提交。
• 依赖项：将 piscina 依赖项更新至 v4.3.1。由 @garg3133 在 #4020 中提交。
• 在会话创建时使用功能发送 POST_SESSION_EVENT。由 @garg3133 在 #4024 中提交。
• 添加 Appium 重置命令。由 @AutomatedTester 在 #4019 中提交。
• 在 Cucumber 中禁用 HTML 报告器。由 @garg3133 在 #4025 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.4.0...v3.4.1

更改内容

修复和改进

• 修复 #3998 – 使用 Browserstack 时，无法为重试测试设置自定义会话状态。由 Priyansh Garg 在 #3999 中提交。
• 修复 #3990 – 使用 Selenium 时，CDP 连接在会话之间没有重置。由 Priyansh Garg 在 #3994 中提交。
• 修复 #3989 – 无法使用对 ShadowRoot 的引用来获取元素。由 Priyansh Garg 在 #3992 中提交。
• 修复 #4003 – 将每个方法的包替换为主 lodash 包。由 Priyansh Garg 在 #4005 中提交。
• 修复 #4007 – 在工作线程中添加 parallel_process_delay。由 @gravityvi 在 #4007 中提交。
• 修复 测试钩子使用 NightwatchBrowser 时出现 TypeScript 错误。由 Priyansh Garg 在 #4004 中提交。
• 添加 waitFor 命令的扩展类型。由 Priyansh Garg 在 #3986 中提交。

依赖项更新

• 升级 Selenium 至 4.16。由 David Burns 在 #4008 中提交。此升级带来了改进的稳定性、新功能和错误修复，增强了 Nightwatch 的整体测试功能。
• 更新 nightwatch-axe-verbose 依赖项，以增强可访问性测试功能，包括改进的 axe-core 集成和对高级配置的支持。由 Priyansh Garg 在 #3993 中提交。

完整变更日志

查看完整历史记录

更改内容

• 修复 Nightwatch 设置/配置文件的类型。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/3876 中提交。
• 更新依赖项。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/3985 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.3.7...v3.3.8

• 添加 – 支持为自定义命令定义自定义返回函数 fe9a01

更改内容

• 修复 测试运行后在 Node v20+ 中，进程会停止 4 分钟。由 @garg3133 在 #3976 中提交。
• 修复 #3639 waitFor 命令不会为陈旧的元素重试。由 @garg3133 在 #3978 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.3.4...v3.3.5

更改内容

• 修复 #3966 – shadow root 在 Firefox 上不起作用。由 @garg3133 提交。
• 修复 #3959 – TS 测试在 ESM 项目中不起作用。由 @garg3133 提交。

更改内容

• 添加对 Browserstack turboscale URL 的检查。由 @nikhlagrwl 在 https://github.com/nightwatchjs/nightwatch/pull/3970 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.3.2...v3.3.3

更改内容

• 添加对 Browserstack turboscale URL 的支持。由 @nikhlagrwl 在 https://github.com/nightwatchjs/nightwatch/pull/3969 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v2.6.22...v2.6.23

更改内容

• 在任何 Selenium 主机上启用并行处理。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3956 中提交。
• 改进了通过插件定义自定义报告器支持。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.3.1...v3.3.2

更改内容

修复

• 更新 waitForElementVisible.js 的 abortOnFailure 描述。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3934 中提交。
• 删除工作线程数量的上限。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3930 中提交。
• 删除 postInstall 步骤。由 @AutomatedTester 在 https://github.com/nightwatchjs/nightwatch/pull/3953 中提交。
• 在使用云服务时为移动设备启用工作线程。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3954 中提交。

依赖项

• 将 Selenium 更新至 4.14。由 @AutomatedTester 在 https://github.com/nightwatchjs/nightwatch/pull/3944 中提交。
• 杂项：更新依赖项。由 @AutomatedTester 在 https://github.com/nightwatchjs/nightwatch/pull/3943 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.2.1...v3.3.0

更改内容

• CVE 2023 43646。由 @AutomatedTester 在 https://github.com/nightwatchjs/nightwatch/pull/3925 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.2.0...v3.2.1

更改内容

• 新功能

  • 添加等待出现命令。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3897 中提交。
  • 为 Nightwatch 钩子设置事件。由 @harshit-bs 在 https://github.com/nightwatchjs/nightwatch/pull/3706 中提交。

• 修复

  • 使用正确的设置参数进行跟踪。由 @swrdfish 在 https://github.com/nightwatchjs/nightwatch/pull/3890 中提交。
  • 允许在类型声明中使用 WebElement 作为可能的 selector。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/3896 中提交。
  • 在子进程工作线程上运行 mocha。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3904 中提交。
  • 在支持的颜色列表中添加 GitHub Actions。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3914 中提交。
  • 从 mocha cli 运行器测试中删除 color 参数。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3919 中提交。
  • 始终考虑从所需功能匹配。由 @gravityvi 在 https://github.com/nightwatchjs/nightwatch/pull/3907 中提交 (#3431)。
  • 在从编程 API 调用时，将设置对象传递给全局钩子。由 @swrdfish 在 https://github.com/nightwatchjs/nightwatch/pull/3850 中提交 (#3849)。

• 依赖项更新

  • 升级至 Selenium 4.13。由 @AutomatedTester 在 https://github.com/nightwatchjs/nightwatch/pull/3920 中提交。

• TypeScript 改进

  • 将实用程序模块迁移到 TS。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/3869 中提交。
  • 在迁移到 TS 之前重构实用程序模块。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/3870 中提交。
  • 将 lib/http 文件迁移到 TS。由 @yashPratp983 在 https://github.com/nightwatchjs/nightwatch/pull/3886 中提交。

• 构建改进

  • 修复 ESLint 规则。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/3891 中提交。
  • 更改执行命令的文件名。由 @garg3133 在 https://github.com/nightwatchjs/nightwatch/pull/3898 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v3.1.3...v3.2.0

更改内容

• 为 v2 提供生命周期事件钩子支持。由 @harshit-bs 在 https://github.com/nightwatchjs/nightwatch/pull/3817 中提交。

完整变更日志: https://github.com/nightwatchjs/nightwatch/compare/v2.6.21...v2.6.22