Add Puppeteer support for Worker JavaScript

[scuffi]

Summary

This adds a public Puppeteer plugin for Computer's Worker JavaScript backend. The plugin bundles Cloudflare's Worker-compatible Puppeteer client, connects it to a Browser Run binding, and keeps Browser and Page objects inside each isolated execution.

It exposes bound launch() and withBrowser() helpers, keeps plugin bindings separate from caller environment values, and closes connection-bound browser sessions when work completes or an execution is disposed.

Usage

Register the plugin on the backend, then import Puppeteer from code executed by Computer:

import { Workspace } from "@cloudflare/computer";
import { WorkerJavaScriptBackend } from "@cloudflare/computer/backends/worker-javascript";
import { puppeteer } from "@cloudflare/computer/plugins/puppeteer";

const workspace = new Workspace({
  storage: ctx.storage,
  backends: [new WorkerJavaScriptBackend({
    loader: env.LOADER,
    plugins: [puppeteer({ browser: env.BROWSER })],
  })],
});

using execution = await workspace.runtime.exec(`
  import { withBrowser } from "@cloudflare/puppeteer";

  export default ({ url }) => withBrowser(async (browser) => {
    const page = await browser.newPage();
    await page.goto(url);
    return { title: await page.title() };
  });
`, { input: { url: "https://example.com" } });

const result = await execution.result();

Browser rendering example

The new self-hosted example accepts a URL and demonstrates scraping, screenshots, page information, and durable browser artifacts. Its research action writes report.md, page.json, and screenshot.png to one Workspace directory from a single isolated execution.

The package and architecture documentation cover Browser Run setup, lifecycle, limits, plugin authoring, and the authority granted to browser-enabled backends.

---

[changeset-bot]

🦋 Changeset detected

Latest commit: 27c19b1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@cloudflare/computer	Minor
@cloudflare/dofs	Minor
@cloudflare/computer-rpc	Minor
@cloudflare/computerd	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Thanks for your interest in Cloudflare Computer.

This repository does not accept unsolicited pull requests. Please use one of the accepted contribution paths instead:

• Bug reports, regressions, and fix proposals: https://github.com/cloudflare/computer/issues/new/choose
• Feature requests, enhancements, and design proposals: https://github.com/cloudflare/computer/discussions

If a maintainer asked you to open this pull request, they can add the allow-pr label and reopen it.

[devin-ai-integration]

Note

This report is out of date. Scroll down for Devin Review's latest report on this PR.

Devin Review found 0 new potential issues.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@cloudflare/computer@148

commit: 27c19b1

[aron-cf]

This is awesome, I'd love to keep worker shell backend in similar parity with the js one. What do you think to adding a browser CLI tool that takes a pupetteer flag or something.

browser puppeteer --url http://example.com run.js
browser puppeteer --url <url> --stdin <run.js

Where run.js is has a global browser instance:

export default async ({ url, browser }) => {
    const page = await browser.newPage();
    await page.goto(url);
    return { title: await page.title() };
});