Puppeteer

Puppeteer Open external link is one of the most popular libraries that abstract the lower-level DevTools protocol from developers and provides a high-level API that you can use to easily instrument Chrome/Chromium and automate browsing sessions. Puppeteer is used for tasks like creating screenshots, crawling pages, and testing web applications.

Puppeteer typically connects to a local Chrome or Chromium browser using the DevTools port. Refer to the Puppeteer API documentation on the Puppeteer.connect() method Open external link for more information.

The Workers team forked a version of Puppeteer and patched it to connect to the Workers Browser Rendering API instead. The changes between Workers Puppeteer fork and the Puppeteer core Open external link are minimal. After connecting, the developers can then use the full Puppeteer API Open external link as they would on a standard setup.

Our version is open sourced and can be found in Cloudflare’s fork of Puppeteer Open external link . The npm can be installed from npmjs Open external link as @cloudflare/puppeteer Open external link :

npm install @cloudflare/puppeteer --save-dev

​​ Use Puppeteer in a Worker

Once the browser binding is configured and the @cloudflare/puppeteer library is installed, Puppeteer can be used in a Worker:

import puppeteer from "@cloudflare/puppeteer";

export default {
	async fetch(request, env) {
		const browser = await puppeteer.launch(env.MYBROWSER);
		const page = await browser.newPage();
		await page.goto("https://example.com");
		const metrics = await page.metrics();
		await browser.close();
		return Response.json(metrics);
	},
};

import puppeteer from "@cloudflare/puppeteer";

interface Env {
	MYBROWSER: Fetcher;
}

export default {
	async fetch(request: Request, env: Env): Promise<Response> {
		const browser = await puppeteer.launch(env.MYBROWSER);
		const page = await browser.newPage();
		await page.goto("https://example.com");
		const metrics = await page.metrics();
		await browser.close();
		return Response.json(metrics);
	},
};

This script launches Open external link the env.MYBROWSER browser, opens a new page Open external link , goes to Open external link https://example.com/ Open external link , gets the page load metrics Open external link , closes Open external link the browser and prints metrics in JSON.

​​ Puppeteer API

The full Puppeteer API can be found in the Cloudflare’s fork of Puppeteer Open external link .