Skip to content

docs: when async work stops, and actions that outlive their page - #1668

Merged
ryansolid merged 1 commit into
v2-rebuildfrom
claude/project-thread-x1ore2
Oct 22, 2026
Merged

ryansolid merged 1 commit into
v2-rebuildfrom
claude/project-thread-x1ore2

Conversation

@ryansolid

Copy link
Copy Markdown
Member

Before: the async guides said Solid drops stale responses with "no AbortController", but never explained that the superseded request keeps running, how to cancel it, or when a run's onCleanup fires. Nothing covered a save that keeps going after the user navigates away.

After: the async concept page has a "Stop the work a run started" section:

  • a run that never committed is cleaned up as soon as it's superseded, so onCleanup + AbortController registered before the first await cancels an unfinished request;
  • the run on screen stays live until its replacement lands;
  • a returned iterable closes on supersede;
  • a pitfall about waiting on a cleanup from inside the update that replaces it.

Data fetching patterns links to that section from the stale-response bullet. Mutations gains a common-problems entry: actions aren't cancelled by navigation (often the action itself navigates), so guard post-yield steps instead and don't retire an action from onCleanup.

How: mirrors solid next 3cbfaf1a (documentation/solid-2.0/05-async-data.md) and the rulings on solidjs/solid#4222 and #4223. It describes released rc.17 behavior only: from() (#4218) and the failed-replacement fix (#4228) are not released yet, so they're left out.


Generated by Claude Code

Adds a "Stop the work a run started" section to the async concept page:
a never-committed run is cleaned up when superseded (so onCleanup +
AbortController cancels an unfinished request), the run on screen stays
live until its replacement lands, and waiting on that cleanup from inside
the replacing update can deadlock. Mutations gains a common-problems entry
for a save that keeps running after navigation (by design; guard post-yield
steps, don't retire actions from onCleanup). Follows solid #4222 / #4223.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015hPxMkC3jg3Uivh65gvaf2
@bolt-new-by-stackblitz

Copy link
Copy Markdown

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@netlify

netlify Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for solid-docs-v2 ready!

Name Link
🔨 Latest commit 8d51dda
🔍 Latest deploy log https://app.netlify.com/projects/solid-docs-v2/deploys/6ada9581b8f40773dad4e364
😎 Deploy Preview https://deploy-preview-1668--solid-docs-v2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@ryansolid
ryansolid merged commit 5e33ea2 into v2-rebuild Oct 22, 2026
8 checks passed
@ryansolid
ryansolid deleted the claude/project-thread-x1ore2 branch October 22, 2026 23:03
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.

2 participants