Skip to main content

migration / Checked 2026-10-18

Move long-running browser Functions from Cloudflare Browser Run to Notte

A migration plan for long-running 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

A deployed handler performs browser work longer than the caller is willing to wait. The execution must have an observable outcome even after the request ends.

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.

Notte is worth evaluating when a Python handler's run history can replace ad hoc background-job tracking. Confirm the actual runtime and cancellation contract rather than borrowing browser session limits.

An existing worker or provider execution service may fit a long task better when its runtime and cancellation behavior are already proven. A successful browser connection is not a runtime entitlement.

Keep the result contract stable

A safe delayed handler, a short caller wait budget and a stored execution reference.

The application can determine the execution's terminal state and browser ownership after the caller stops waiting, then retrieve or cancel work through the documented path.

Preserve the evidence contract across the move: Caller timeout, execution reference, handler terminal state, cancellation result and browser release.

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.

  • Record source caller, handler and browser timeouts as separate budgets.
  • Port the handler without changing the business completion check.
  • Prove post-timeout status lookup, cancellation and browser cleanup before moving long jobs.

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 safe delayed handler, a short caller wait budget and a stored execution reference.
Pass conditionThe application can determine the execution's terminal state and browser ownership after the caller stops waiting, then retrieve or cancel work through the documented path.
Negative caseInterrupt the caller and request cancellation in a controlled test. Inspect both the handler outcome and whether its browser remains allocated.
Evidence to retainCaller timeout, execution reference, handler terminal state, cancellation result and browser release.

A reason to delay or keep the source

Interrupt the caller and request cancellation in a controlled test. Inspect both the handler outcome and whether its browser remains allocated.

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 ↗