Skip to main content

migration / Checked 2026-10-18

Move webhook-triggered browser Functions from Cloudflare Browser Run to Notte

A migration plan for webhook-triggered browser Functions: retain the business check, replace Cloudflare Browser Run's provider-owned resources, and prove the Notte workflow before cutover.

Decide whether this move earns its cost

An application event causes a browser operation. Delivery can be repeated, while the browser may finish after the original HTTP caller stops waiting.

Cloudflare can be an economical architectural choice when Workers and the surrounding scheduling already exist in your application. Notte is worth evaluating when a browser, deployed Python handler and authentication workflow should share a product rather than a Workers composition.

Consider Notte when an HTTP-invoked Python Function can own the browser task and expose its run history. Your application still needs its own event identity and duplicate-delivery policy.

A TypeScript Function, browser-local action or existing external worker may be the better fit when it already integrates with the event system. Moving the browser does not require moving every webhook handler.

Keep the result contract stable

A test event with a stable application event ID and an operation whose resulting object can be counted.

The application tracks a terminal run and the intended number of website changes for that event, including after duplicate delivery.

Preserve the evidence contract across the move: Event ID, invocation acknowledgement, execution ID, terminal state and resulting website object.

Map the workflow's resources

RequirementCloudflare Browser RunNotte
Code executionWorkers compositionPython Functions
Scheduled executionWorkers trigger compositionNative
Recordings / replayBetaDocumented

Sources: developers.cloudflare.com [1] ↗docs.notte.cc [2] ↗docs.notte.cc [3] ↗

Where the code runs

Cloudflare Browser Run: Deploy browser automation within a Cloudflare Worker or connect to Browser Run from an external process over CDP. Workers provide the execution layer; compare their runtime and deployment model separately from browser access.

Notte: Functions deploy Python code with a run() entry point. Invoke them over HTTP or with an SDK, inspect run history, and roll back code by redeploying an earlier version as the latest version.

Sources: developers.cloudflare.com [1] ↗docs.notte.cc [2] ↗

Deployment ownership

Cloudflare Browser Run: A Worker-based deployment fits Cloudflare application infrastructure; direct CDP keeps the controller elsewhere. Durable Objects are a composition for stateful browser work rather than a generic persistent browser profile.

Notte: Use a remote browser from your existing process or deploy the browser automation as a Notte Function. These choices put lifecycle, scheduling and monitoring responsibilities in different places.

Sources: developers.cloudflare.com [1] ↗docs.notte.cc [2] ↗

Pricing model

Cloudflare Browser Run: Price browser usage and the Worker execution components required by the workload. The Browser Run pricing page, rather than a single browser-hour estimate, defines included allowances and applicable limits.

Notte: The public usage rates are $0.01 per browser-hour, $0.05 per Function-hour and $10 per GB of managed proxy traffic. Paid plans return their price as usage credits. Price the relevant meters and plan eligibility for the workload.

Sources: developers.cloudflare.com [1] ↗notte.cc [2] ↗

Cut over one responsibility at a time

For this Cloudflare Browser Run-to-Notte migration, keep the business assertion outside provider resource management. Source profile, connection, file and execution IDs are not valid target IDs; use a documented transfer path or establish the corresponding resource in Notte.

Retain source job history and a rollback route until the target pilot passes. A migration checklist is not evidence that saved state or runtime behavior is automatically portable.

  • Preserve the application's event ID when replacing invocation plumbing.
  • Invoke the target from a test event and track its terminal result separately from the initial response.
  • Route one event partition to the target and keep duplicate handling enabled during cutover.

Sources: developers.cloudflare.com [1] ↗docs.notte.cc [2] ↗docs.notte.cc [3] ↗

A proposed acceptance case

This is an evaluation design, not a claim that this workflow has been executed successfully on every provider.

Part of the testRequired observation
Controlled inputA test event with a stable application event ID and an operation whose resulting object can be counted.
Pass conditionThe application tracks a terminal run and the intended number of website changes for that event, including after duplicate delivery.
Negative caseSend the same event twice and interrupt the first caller. Verify that run tracking and idempotency still describe the intended outcome.
Evidence to retainEvent ID, invocation acknowledgement, execution ID, terminal state and resulting website object.

A reason to delay or keep the source

Send the same event twice and interrupt the first caller. Verify that run tracking and idempotency still describe the intended outcome.

Cloudflare Browser Run: A Worker and a browser session have separate resource and lifecycle constraints. Confirm the chosen browser library and binding path instead of assuming an unchanged local browser script will deploy directly.

Delay cutover when the target's selected plan, required artifact path or supported website-account flow is not established. Resolve that gap before moving real jobs, even if the rate comparison favors the target.

Sources: developers.cloudflare.com [1] ↗notte.cc [2] ↗

Keep comparing

Put the workflow to the test.

Try Notte Read the quickstart ↗