时钟
准确模拟时间相关行为对于验证应用程序的正确性至关重要。了解更多关于时钟模拟。
请注意,时钟是为整个BrowserContext安装的,因此所有页面和 iframe 中的时间都由同一个时钟控制。
方法
fast_forward
新增于: v1.45通过跳跃式前进时间来提前时钟。最多只触发一次到期计时器。这相当于用户合上笔记本电脑盖子一段时间后,在给定时间后重新打开。
用法
- 同步
- 异步
page.clock.fast_forward(1000)
page.clock.fast_forward("30:00")
await page.clock.fast_forward(1000)
await page.clock.fast_forward("30:00")
参数
-
时间可以是提前时钟的毫秒数,也可以是人类可读的字符串。有效的字符串格式是“08”表示八秒,“01:00”表示一分钟,“02:34:10”表示两小时,34 分钟和十秒。
返回
install
新增于: v1.45为以下时间相关函数安装假的实现
Date
setTimeout
clearTimeout
setInterval
clearInterval
requestAnimationFrame
cancelAnimationFrame
requestIdleCallback
cancelIdleCallback
performance
伪造计时器用于手动控制测试中的时间流。它们允许您推进时间,触发计时器,并控制时间相关函数的行为。有关更多信息,请参阅clock.run_for()和clock.fast_forward()。
用法
clock.install()
clock.install(**kwargs)
参数
返回
pause_at
新增于: v1.45通过时间跳转来提前时钟并暂停时间。一旦调用此方法,除非调用clock.run_for()、clock.fast_forward()、clock.pause_at()或clock.resume(),否则不会触发计时器。
最多只触发一次到期计时器。这相当于用户合上笔记本电脑盖子一段时间,然后在指定时间重新打开并暂停。
用法
- 同步
- 异步
page.clock.pause_at(datetime.datetime(2020, 2, 2))
page.clock.pause_at("2020-02-02")
await page.clock.pause_at(datetime.datetime(2020, 2, 2))
await page.clock.pause_at("2020-02-02")
为了获得最佳结果,请在导航页面之前安装时钟,并将其设置为比预定测试时间稍早的时间。这确保了所有计时器在页面加载期间正常运行,防止页面卡住。一旦页面完全加载,您就可以安全地使用clock.pause_at()来暂停时钟。
- 同步
- 异步
# Initialize clock with some time before the test time and let the page load
# naturally. `Date.now` will progress as the timers fire.
page.clock.install(time=datetime.datetime(2024, 12, 10, 8, 0, 0))
page.goto("https://:3333")
page.clock.pause_at(datetime.datetime(2024, 12, 10, 10, 0, 0))
# Initialize clock with some time before the test time and let the page load
# naturally. `Date.now` will progress as the timers fire.
await page.clock.install(time=datetime.datetime(2024, 12, 10, 8, 0, 0))
await page.goto("https://:3333")
await page.clock.pause_at(datetime.datetime(2024, 12, 10, 10, 0, 0))
参数
返回
resume
新增于: v1.45恢复计时器。一旦调用此方法,时间将恢复流动,计时器将照常触发。
用法
clock.resume()
返回
run_for
新增于: v1.45提前时钟,触发所有时间相关的回调。
用法
- 同步
- 异步
page.clock.run_for(1000);
page.clock.run_for("30:00")
await page.clock.run_for(1000);
await page.clock.run_for("30:00")
参数
-
时间可以是提前时钟的毫秒数,也可以是人类可读的字符串。有效的字符串格式是“08”表示八秒,“01:00”表示一分钟,“02:34:10”表示两小时,34 分钟和十秒。
返回
set_fixed_time
新增于: v1.45使Date.now
和new Date()
始终返回固定的假时间,并保持所有计时器运行。
此方法适用于您只需要使用预定义时间进行测试的简单场景。对于更高级的场景,请改用clock.install()。阅读时钟模拟文档以了解更多信息。
用法
- 同步
- 异步
page.clock.set_fixed_time(datetime.datetime.now())
page.clock.set_fixed_time(datetime.datetime(2020, 2, 2))
page.clock.set_fixed_time("2020-02-02")
await page.clock.set_fixed_time(datetime.datetime.now())
await page.clock.set_fixed_time(datetime.datetime(2020, 2, 2))
await page.clock.set_fixed_time("2020-02-02")
参数
返回
set_system_time
新增于: v1.45设置系统时间,但不触发任何计时器。使用此功能测试网页对时间偏移的反应,例如从夏令时切换到冬令时,或更改时区。
用法
- 同步
- 异步
page.clock.set_system_time(datetime.datetime.now())
page.clock.set_system_time(datetime.datetime(2020, 2, 2))
page.clock.set_system_time("2020-02-02")
await page.clock.set_system_time(datetime.datetime.now())
await page.clock.set_system_time(datetime.datetime(2020, 2, 2))
await page.clock.set_system_time("2020-02-02")
参数
返回