[Browser Run] Add tabs vs sessions FAQ

[kathayl]

Summary

Adds a new Session management FAQ entry to the Browser Run FAQ page that explains when to reuse a browser session and open tabs versus launching a fresh browser for each task.

The entry covers:

• Why reusing sessions and tabs keeps usage within concurrent browser and new browser instance rate limits.
• The memory/process tradeoff of opening too many tabs in one browser.
• Using incognito browser contexts (browser.createBrowserContext() / browser.newContext()) for isolation when reusing sessions.
• Code examples for Puppeteer and Playwright.
• When a fresh browser is still the right choice.

This addresses a recurring customer question about whether to reuse Browser Sessions/tabs instead of opening a fresh browser per task.

Screenshots (optional)

Documentation checklist

• The change adheres to the documentation style guide.

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/docs/browser-run/	@mchenco, @cloudflare/product-owners, @celso, @kathayl, @dcpena, @meddulla, @simonabadoiu, @jonnyparris, @ruifigueira, @Refaerds, @omarmosid

[kathayl]

/bonk

[cloudflare-docs-bot]

Review

✅ No issues found in commit fcc3c0e.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

_{No code review issues found.}

Conventions

_{No convention issues found.}

Style Guide Review

_{No style-guide issues found.}

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command	Description
/review	Runs a review now. Incremental if a prior review exists, full if not.
/full-review	Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit	Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review	Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.

[ask-bonk]

Here's a summary of PR #32098:

Title: [Browser Run] Add tabs vs sessions FAQ

Author: kathayl

Status: Open (1 commit, +44/-1 in src/content/docs/browser-run/faq.mdx)

What changed?
Adds a new "Session management" FAQ entry to the Browser Run FAQ page that addresses a recurring customer question about when to reuse a browser session/open tabs versus launching a fresh browser per task. The entry covers:

• Keeping usage within concurrent browser and new browser instance rate limits
• Memory/process tradeoffs of too many tabs
• Using incognito browser contexts (browser.createBrowserContext() / browser.newContext()) for isolation
• Code examples for Puppeteer and Playwright
• When to still choose a fresh browser

Thread so far:

• github-actions flagged that CODEOWNER review is required from the browser-run owners (including @mchenco, @celso, @kathayl, @dcpena, and others).
• cloudflare-docs-bot kicked off its automated copy/style review, currently pending for commit d01bef3.

No human review comments have been posted yet.

github run

[github-actions]

Nimbus Preview URL: https://nimbus-d01bef3e.preview.developers.cloudflare.com
Nimbus Preview Branch URL: https://nimbus-kliao-browser-run-tabs-vs-sessions.preview.developers.cloudflare.com

[kathayl]

/bonk implement your warning and suggestion

[ask-bonk]

Fixed both style guide findings in src/content/docs/browser-run/faq.mdx:

1. SG-0c51636f4a81 — Removed the trailing ? from the H3 heading on line 196.
2. SG-802229a191be — Split the semicolon-joined sentence on line 200 into two separate sentences.

Both changes align with the documentation style guide. The opencode infrastructure will commit these automatically to PR #32098.

github run

[github-actions]

Preview URL: https://d01bef3e.preview.developers.cloudflare.com
Preview Branch URL: https://kliao-browser-run-tabs-vs-sessions.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/browser-run/faq/	https://kliao-browser-run-tabs-vs-sessions.preview.developers.cloudflare.com/browser-run/faq/