可否将Promise作为assert入参？assert.ok是否会等待Promise执行完成？

你遇到的超时报错大概率就是assert.ok没有等待Promise执行完成导致的，具体原因和解决方案如下：

核心原因 #

Node.js 原生assert模块的同步断言方法不具备自动等待异步Promise执行的能力。你直接将$browser.waitForAndFindElement返回的Promise传入assert.ok时，方法只会判断传入的Promise对象本身为真值，直接通过断言校验，但不会等待元素查找逻辑执行完成。
后续元素查找超时抛出的异常会成为未捕获的异步错误，最终触发全局的任务超时告警。

修复方案 #

• 优先用async/await等待异步操作完成后再做断言，修改代码如下：

// 注意当前执行的函数需要标注async
const targetElement = await $browser.waitForAndFindElement($driver.By.id("framedContent"), 5000);
assert.ok(targetElement);

• 如果你使用的测试框架支持异步断言（比如Mocha、Chai），也可以直接调用框架提供的异步断言方法，省去手动await的处理。

额外排查建议 #

如果修改后还是出现超时，可以进一步排查两个场景：

• 确认ID为framedContent的元素是否嵌套在iframe中，若是需要先调用$driver.switchTo().frame()切换到对应iframe后再执行元素查找
• 确认5000ms的等待阈值是否符合页面实际加载耗时，若页面渲染速度慢可以适当调大等待时长验证

内容的提问来源于stack exchange，提问作者christopherhlee