DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk5 min

How to Override the Browser Date with Puppeteer

Use Puppeteer’s pre-navigation Date patch for fixed JavaScript reads, CDP virtual time for scheduler behavior, and timezone emulation for local-time rendering.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To make a page see a fixed JavaScript date, register a Date override with page.evaluateOnNewDocument() before navigating. If you need timers and browser scheduling to use a synthetic clock, use Chrome DevTools Protocol (CDP) virtual time instead. If you need local-time formatting in a particular zone, set that separately with page.emulateTimezone().

Choose the right kind of date override

These techniques affect different things. A page-level patch controls JavaScript Date calls in the page context. CDP virtual time supplies a synthetic clock for browser frames and scheduler behavior. Timezone emulation changes how local time is interpreted; it does not choose a new instant.

As an Amazon Associate I earn from qualifying purchases.

Need Use What it changes
Make startup JavaScript read a specific date page.evaluateOnNewDocument() with a Date patch No-argument new Date() and Date.now() in the patched page context
Run timer and scheduler work against synthetic time CDP Emulation.setVirtualTimePolicy The browser’s virtual-time source for frames; behavior depends on the selected policy and budget
Test local date or time rendering in a zone page.emulateTimezone() Timezone behavior, not the underlying instant

Puppeteer documents page.evaluate() as evaluating a function in the page’s context. That is useful for inspecting or changing an already-loaded page, but it can be too late for startup code that has already read or cached date values. The pre-script hook is page.evaluateOnNewDocument().

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Fix JavaScript Date before the site runs

Register the override before page.goto(). This example fixes no-argument date construction and Date.now(), while preserving explicit arguments such as new Date('2025-01-01').

#1 Best Overall
Sale
Logitech M185 Compact Ambidextrous 2.4 GHz Wireless Mouse - Swift Grey
  • Compact Mouse: With a comfortable and contoured shape, this Logitech ambidextrous wireless mouse feels great in either right or left hand and is far superior to a touchpad
  • Durable and Reliable: This USB wireless mouse features a line-by-line scroll wheel, up to 1 year of battery life (2) thanks to a smart sleep mode function, and comes with the included AA battery
  • Universal Compatibility: Your Logitech mouse works with your Windows PC, Mac, or laptop, so no matter what type of computer you own today or buy tomorrow your mouse will be compatible
  • Plug and Play Simplicity: Just plug in the tiny nano USB receiver and start working in seconds with a strong, reliable connection to your wireless computer mouse up to 33 feet / 10 m (5)
  • Better than touchpad: Get more done by adding M185 to your laptop; according to a recent study, laptop users who chose this mouse over a touchpad were 50% more productive (3) and worked 30% faster (4)
const fixedTime = new Date('2030-01-02T03:04:05.000Z').valueOf();

await page.evaluateOnNewDocument((timestamp) => {
  const OriginalDate = Date;

  class FixedDate extends OriginalDate {
    constructor(...args) {
      if (args.length === 0) {
        super(timestamp);
      } else {
        super(...args);
      }
    }

    static now() {
      return timestamp;
    }
  }

  Object.setPrototypeOf(FixedDate, OriginalDate);
  globalThis.Date = FixedDate;
}, fixedTime);

await page.goto('https://example.test');

The timestamp is calculated in Node.js and passed to the page function through Puppeteer’s argument mechanism. The hook runs before the page’s scripts and also applies to child frames when they are attached or navigated, as described in the Puppeteer API reference.

This is a page-JavaScript patch, not a guarantee that every worker, isolated realm, or browser-native API sees a frozen wall clock. Check those contexts separately if they are part of the test. It also does not make timers advance against a synthetic scheduler clock.

Rank #2
Sale
Logitech G305 Lightspeed Wireless Gaming Mouse - Black | 12,000 DPI, Lightweight, 6 Programmable Buttons, 250h Battery, On-Board Memory, Compatible with PC and Mac
  • The next-generation optical HERO sensor delivers incredible performance and up to 10x the power efficiency over previous generations, with 400 IPS precision and up to 12,000 DPI sensitivity
  • Ultra-fast LIGHTSPEED wireless technology gives you a lag-free gaming experience, delivering incredible responsiveness and reliability with 1 ms report rate for competition-level performance
  • G305 wireless mouse boasts an incredible 250 hours of continuous gameplay on just 1 AA battery; switch to Endurance mode via Logitech G HUB software and extend battery life up to 9 months
  • Wireless does not have to mean heavy, G305 lightweight mouse provides high maneuverability coming in at only 3.4 oz thanks to efficient lightweight mechanical design and ultra-efficient battery usage
  • The durable, compact design with built-in nano receiver storage makes G305 not just a great portable desktop mouse, but also a great laptop travel companion, use with a gaming laptop and play anywhere

Use CDP virtual time for timers and scheduler behavior

For a synthetic browser clock rather than just patched JavaScript date reads, create a CDP session and send Emulation.setVirtualTimePolicy. Puppeteer’s Page API lists createCDPSession(). The protocol describes virtual time as replacing real time with a synthetic time source for all frames.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
const client = await page.createCDPSession();

await client.send('Emulation.setVirtualTimePolicy', {
  policy: 'pauseIfNetworkFetchesPending',
  initialVirtualTime: Date.parse('2030-01-02T03:04:05.000Z') / 1000,
  budget: 5000,
});

await page.goto('https://example.test');

The protocol parameter initialVirtualTime is in epoch seconds. JavaScript’s Date.parse() returns milliseconds, hence the division by 1000. The budget is virtual milliseconds; when it expires, virtual time pauses and the protocol emits virtualTimeBudgetExpired. The available policies include advance, pause, and pauseIfNetworkFetchesPending.

Rank #3
Sale
Logitech M185 Compact Ambidextrous Wireless Mouse with Rubber Grips - Blue
  • Compact Mouse: With a comfortable and contoured shape, this Logitech ambidextrous wireless mouse feels great in either right or left hand and is far superior to a touchpad
  • Durable and Reliable: This USB wireless mouse features a line-by-line scroll wheel, up to 1 year of battery life (2) thanks to a smart sleep mode function, and comes with the included AA battery
  • Universal Compatibility: Your Logitech mouse works with your Windows PC, Mac, or laptop, so no matter what type of computer you own today or buy tomorrow your mouse will be compatible
  • Plug and Play Simplicity: Just plug in the tiny nano USB receiver and start working in seconds with a strong, reliable connection to your wireless computer mouse up to 33 feet / 10 m (5)
  • Better than touchpad: Get more done by adding M185 to your laptop; according to a recent study, laptop users who chose this mouse over a touchpad were 50% more productive (3) and worked 30% faster (4)

Placement and policy matter. Some tests need the policy set before navigation; others need a bounded advance after the page loads. Verify the sequence with the exact Chromium build and policy your test requires. The Chrome DevTools Protocol Emulation documentation marks this command experimental, so do not assume identical behavior across browser versions. Close or detach the CDP session when the test is finished, following the lifecycle supported by your Puppeteer version.

Set the timezone separately

When assertions depend on local clock methods or date formatting, set a timezone independently:

Rank #4
Amazon Basics 3-Button USB Wired Mouse with Responsive Tracking, Plug & Play, Compatible with Windows and Mac, Black
  • Computer mouse for easily navigating a computer interface; click, scroll, and more
  • USB-A wired connection; if existing device only supports USB-C, an additional adapter will be required
  • High-definition (1000 dpi) optical tracking ensures responsive cursor control for precise tracking and easy text selection
  • 3 buttons offer effortless fingertip control
  • Plug-and-go ready for instant use
await page.emulateTimezone('America/Los_Angeles');

Puppeteer’s emulateTimezone() API changes the page timezone; passing null disables the emulation. Apply timezone and clock settings before navigation if startup code depends on them. A fixed instant can render as different local calendar dates in different zones, especially near midnight; changing the zone does not change that instant.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Common mistakes and fixes

  • Overriding after navigation: page.evaluate() may run after the site has read or cached date functions. Register the patch with evaluateOnNewDocument() before goto().
  • Using timezone emulation as a clock: emulateTimezone() changes timezone behavior, not the instant. Combine it with a date patch or virtual time if both are needed.
  • Expecting a Date patch to advance timers: The patch controls page JavaScript date reads; it does not set CDP’s scheduler policy. Use virtual time when timer progression is part of the test, and verify the Chromium behavior.
  • Missing code in a frame: Use the pre-navigation hook for child frames, or virtual time for the browser-wide frame clock as supported by the protocol. Check any worker or separate realm explicitly.
  • Using the wrong virtual-time units: initialVirtualTime is epoch seconds, not JavaScript milliseconds; convert a Date.parse() result by dividing by 1000. The budget is virtual milliseconds.
  • Assuming CDP compatibility: The virtual-time command is experimental. Check it against the Chrome or Chromium version actually used in CI and adjust the policy or setup sequence if needed.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Version and reliability considerations

Puppeteer documentation versions surfaced for these APIs include 25.10.0 through 25.12.0; the CDP page cited here is the current “tot” protocol reference, and labels virtual-time policy experimental. These pages do not establish that a given command behaves identically in every Puppeteer/Chromium pairing. Check the API reference and protocol supported by the versions installed in your project, then assert both the page’s observed date and the timer behavior your test depends on.

Best Value
Sale
Acer Wireless Mouse for Laptop, 2.4GHz Computer Mouse 3 Adjustable 1600 DPI
  • 【Plug and Play for Home/Office/School】The wireless computer mouse features 2.4GHz connectivity, delivering a stable, interference-free connection up to 32ft. Designed for 𝐦𝐞𝐝𝐢𝐮𝐦 𝐭𝐨 𝐥𝐚𝐫𝐠𝐞 𝐬𝐢𝐳𝐞𝐝 𝐡𝐚𝐧𝐝𝐬, it ensures comfortable use all day. Simply plug in the USB-A receiver for instant pairing—no drivers needed. 📌📌 If the mouse isn’t suitable, place the USB receiver in the battery compartment and return both.
  • 【3 Levels Adjustable DPI】This travel USB mouse offers 3 adjustable DPI settings (800, 1200, 1600), allowing you to customize sensitivity for precise design work. Effortlessly switch to match your task and elevate your productivity. 📌 Please remove the film at the bottom of the mouse before use.
  • 【Effortless Browsing】Equipped with forward and backward buttons, this computer mice streamlines your workflow, making it easy to navigate through web pages and files with a simple click. 📌Side button does not work on Mac.
  • 【Visible Indicator Light】 The pc mouse features a visual indicator for DPI levels and low battery alerts. The red light flashes once for 800 DPI, twice for 1200 DPI, and three times for 1600 DPI. When the battery level is below 10%, the light flashes red until the mouse is completely out of power.
  • 【Click to Wake】With smart sleep mode, it saves power by standby after 10 inactive minutes, just 2-3 clicks to wake. This efficient design delivers 3x longer battery life than motion-wake mice. Engineered for durability, its buttons and scroll wheel are tested for 10 million clicks, ensuring long-term reliability and consistent performance.

Or skip the browser setup

If your goal is to capture a page rather than test its date logic, ScreenshotNeo is a website screenshot API and MCP server. It does not replace Puppeteer date mocking, but a single request can capture a URL without setting up a browser locally.

See the ScreenshotNeo API documentation for request options. Example cURL call:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.test -o shot.webp

ScreenshotNeo removes cookie banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, and failed loads are not billed. Its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. Sign up for free.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Frequently Asked Questions

Does overriding Date change the server’s date?

No. These techniques affect the browser-side test environment; they do not change the clock used by the website’s server.

Can I combine a fixed instant with a timezone?

Yes. Set the instant with a page patch or CDP virtual time, and set local-time behavior independently with timezone emulation.

Quick Recap

SaleBestseller No. 1
Logitech M185 Compact Ambidextrous 2.4 GHz Wireless Mouse - Swift Grey
Logitech M185 Compact Ambidextrous 2.4 GHz Wireless Mouse - Swift Grey
Product carbon footprint: 3.97 kg CO2e; Contoured shape: Gives you more comfort and control
$14.85
SaleBestseller No. 3
Bestseller No. 4
Amazon Basics 3-Button USB Wired Mouse with Responsive Tracking, Plug & Play, Compatible with Windows and Mac, Black
Amazon Basics 3-Button USB Wired Mouse with Responsive Tracking, Plug & Play, Compatible with Windows and Mac, Black
Computer mouse for easily navigating a computer interface; click, scroll, and more; 3 buttons offer effortless fingertip control
$9.70

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.