Skip to content

docs: add SPA scraping guide with tab-isolation pattern#1320

Open
ejaircastillo wants to merge 2 commits into
vercel-labs:mainfrom
ejaircastillo:docs/spa-scraping-guide
Open

docs: add SPA scraping guide with tab-isolation pattern#1320
ejaircastillo wants to merge 2 commits into
vercel-labs:mainfrom
ejaircastillo:docs/spa-scraping-guide

Conversation

@ejaircastillo
Copy link
Copy Markdown

@ejaircastillo ejaircastillo commented May 3, 2026

Summary

  • add docs/spa-scraping.md with the tab-isolation pattern for ref-based scraping in dynamic SPAs
  • document the source-tab invariant, ref lifecycle, sequential extraction loop, cold-start prewarm, and wait tuning
  • align the runnable CLI example with current syntax ( ab + snapshot, and argument-mode batch --json)
  • improve readability of the batch example and clarify batch --json result indexing

Context

ejaircastillo and others added 2 commits May 3, 2026 13:08
Adds docs/spa-scraping.md documenting the tab-isolation pattern for ref-based scraping of dynamic SPAs. Covers the Source-Tab Invariant, ref lifecycle, sequential extraction with runnable example using batch and stable tab ids, cold-start optimization, and wait tuning.

Closes vercel-labs#853

Co-Authored-By: Oz <oz-agent@warp.dev>
Clarifies the argument-mode batch example with multiline formatting and adds an explicit note that batch --json returns an array where index 2 is the snapshot result and index 3 is the URL result.

Co-Authored-By: Oz <oz-agent@warp.dev>
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 3, 2026

@ejaircastillo is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

SPA Scraping Pattern: Preserving accessibility refs with tab isolation

1 participant