(Created on )

Puppeteer: Unknown value for options.waitUntil:

waitUntil contains a value absent from Puppeteer's lifecycle mapping.


waitUntil contains a value absent from Puppeteer’s lifecycle mapping.

Error message

Unknown value for options.waitUntil:

How this error happens

waitUntil accepts Puppeteer’s lifecycle names. ready is an application concept, not a supported navigation event.

The snippets use an open Puppeteer page named page.

await page.goto(
    "https://example.com",
    {
        waitUntil: "ready",
    }
);

How to fix

Choose a supported lifecycle event, then wait for an application-specific selector if needed.

await page.goto(
    "https://example.com",
    {
        waitUntil: "domcontentloaded",
    }
);

Things to keep in mind

The supported lifecycle values are load, domcontentloaded, networkidle0 and networkidle2. Network idleness does not prove that application data is ready.

All Puppeteer errors

Keep Reading

Puppeteer Guides

All Guides →