Puppeteer: Unsupported browser
An unsupported browser name was supplied to the browser CLI or Puppeteer configuration.
An unsupported browser name was supplied to the browser CLI or Puppeteer configuration.
Error message
Unsupported browser '{value}'
{value} is replaced by the value shown in your error message.
How this error happens
The standalone browser-management CLI accepts specific browser or artifact names. edge is not one of them.
Run the following commands in your project terminal.
npx @puppeteer/browsers install edge
How to fix
Use a supported artifact name, such as Chrome. For normal Puppeteer setup, install the browser expected by the package.
npx puppeteer browsers install
If the error comes from configuration
An invalid default browser in .puppeteerrc.cjs can produce the same error without the CLI’s quotation marks:
module.exports = {
defaultBrowser: "edge",
};
Choose Chrome or Firefox instead:
module.exports = {
defaultBrowser: "chrome",
};
Puppeteer reads this setting during startup, so an invalid value can prevent browser setup from completing.
Things to keep in mind
CLI artifact names include chrome, chrome-headless-shell, chromium, chromedriver and firefox. Puppeteer’s defaultBrowser configuration is narrower: it accepts only chrome or firefox.