Test

Status: PASS (SDK install) | NOT-RUN (browser launch - requires Chromium binary approval) Install method: npm

What was actually run (2026-06-30)

cd /tmp/browser-tools-smoke && npm install puppeteer
node -e "const p = require('./node_modules/puppeteer/package.json'); console.log(p.name + '@' + p.version)"

Actual output:

puppeteer@25.2.1

PASS for install. npm flagged the postinstall script (Chromium download) as needing npm approve-scripts due to security policy. The package itself resolves and loads. Browser launch was not executed because it requires a running display and approved Chromium binary.

Full browser launch smoke test (not run)

npm approve-scripts puppeteer
node smoke.mjs  # launches Chromium, navigates to example.com, prints title

Requires Chromium to be downloaded (handled by Puppeteer's postinstall) and a display environment.

Common failure modes

Error	Likely Cause	Fix
Could not find Chrome	Chromium not downloaded	Run npx puppeteer browsers install chrome
Postinstall blocked	npm security policy	Run npm approve-scripts puppeteer
Timeout on goto	Network or bot detection	Use cloud browser backend