跳转到主要内容

时钟

准确模拟时间相关的行为对于验证应用程序的正确性至关重要。了解更多关于时钟模拟

请注意,时钟是为整个浏览器上下文安装的,所以所有页面和 iframe 中的时间都由同一个时钟控制。


方法

fastForward

新增于: v1.45 clock.fastForward

通过跳跃式前进时间来提前时钟。最多只触发一次到期计时器。这相当于用户合上笔记本电脑盖子一段时间后,在给定时间后重新打开。

用法

await page.clock.fastForward(1000);
await page.clock.fastForward('30:00');

参数

  • ticks 数字 | 字符串#

    时间可以是提前时钟的毫秒数,也可以是人类可读的字符串。有效的字符串格式是“08”表示八秒,“01:00”表示一分钟,“02:34:10”表示两小时,34 分钟和十秒。

返回


install

新增于: v1.45 clock.install

为以下时间相关函数安装假的实现

  • Date
  • setTimeout
  • clearTimeout
  • setInterval
  • clearInterval
  • requestAnimationFrame
  • cancelAnimationFrame
  • requestIdleCallback
  • cancelIdleCallback
  • performance

假计时器用于在测试中手动控制时间流。它们允许您提前时间、触发计时器以及控制时间相关函数的行为。有关更多信息,请参阅clock.runFor()clock.fastForward()

用法

await clock.install();
await clock.install(options);

参数

返回


pauseAt

新增于: v1.45 clock.pauseAt

通过跳跃式前进时间并暂停时间来提前时钟。一旦调用此方法,除非调用clock.runFor()clock.fastForward()clock.pauseAt()clock.resume(),否则不会触发计时器。

最多只触发一次到期计时器。这相当于用户合上笔记本电脑盖子一段时间,然后在指定时间重新打开并暂停。

用法

await page.clock.pauseAt(new Date('2020-02-02'));
await page.clock.pauseAt('2020-02-02');

为获得最佳效果,请在导航页面之前安装时钟,并将其设置为比预期测试时间稍早的时间。这确保了在页面加载期间所有计时器正常运行,防止页面卡住。一旦页面完全加载,您就可以安全地使用clock.pauseAt()来暂停时钟。

// 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: new Date('2024-12-10T08:00:00') });
await page.goto('https://:3333');
await page.clock.pauseAt(new Date('2024-12-10T10:00:00'));

参数

返回


resume

新增于: v1.45 clock.resume

恢复计时器。一旦调用此方法,时间将恢复流动,计时器将照常触发。

用法

await clock.resume();

返回


runFor

新增于: v1.45 clock.runFor

提前时钟,触发所有时间相关的回调。

用法

await page.clock.runFor(1000);
await page.clock.runFor('30:00');

参数

  • ticks 数字 | 字符串#

    时间可以是提前时钟的毫秒数,也可以是人类可读的字符串。有效的字符串格式是“08”表示八秒,“01:00”表示一分钟,“02:34:10”表示两小时,34 分钟和十秒。

返回


setFixedTime

新增于: v1.45 clock.setFixedTime

使Date.nownew Date()始终返回固定的假时间,并保持所有计时器运行。

在只需要使用预定义时间进行测试的简单场景中,请使用此方法。对于更高级的场景,请使用clock.install()。阅读时钟模拟文档以了解更多信息。

用法

await page.clock.setFixedTime(Date.now());
await page.clock.setFixedTime(new Date('2020-02-02'));
await page.clock.setFixedTime('2020-02-02');

参数

返回


setSystemTime

新增于: v1.45 clock.setSystemTime

设置系统时间,但不触发任何计时器。使用此功能测试网页对时间偏移的反应,例如从夏令时切换到冬令时,或更改时区。

用法

await page.clock.setSystemTime(Date.now());
await page.clock.setSystemTime(new Date('2020-02-02'));
await page.clock.setSystemTime('2020-02-02');

参数

返回