Skip to content

docs(signals): clarify untrack with async reads - #4169

Merged
ryansolid merged 1 commit into
solidjs:nextfrom
Neekoras:docs-1635-untrack-async
Oct 20, 2026
Merged

ryansolid merged 1 commit into
solidjs:nextfrom
Neekoras:docs-1635-untrack-async

Conversation

@Neekoras

Copy link
Copy Markdown

Refs solidjs/solid-docs#1635.

The Solid 2 untrack reference is generated from this JSDoc. Explain that untrack prevents dependency tracking but does not suppress an unresolved async read: the owning computation still suspends and retries when the source first settles. The text also distinguishes isPending and latest from an initial fallback, and shows loadingValue for a read that must return immediately.

This changes documentation only. The existing autodispose-contract, strict-read-pending-store, and loading-value tests cover the behavior described. Prettier and git diff --check pass locally.

Prepared with Codex AI assistance and checked against the current source and tests.

@changeset-bot

changeset-bot Bot commented Oct 20, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: ad4d7e4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@ryansolid
ryansolid merged commit 5a4b2e8 into solidjs:next Oct 20, 2026
7 checks passed
@codspeed

codspeed Bot commented Oct 20, 2026

Copy link
Copy Markdown

Merging this PR will degrade performance by 10.7%

⚠️ 3 benchmarks spent significant time in system calls

System calls cannot be consistently instrumented, so they are not included in the measure, which understates the real cost. Please switch to the Walltime instrument to accurately measure system calls.

Measurement and system calls

⚠️ Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

❌ 1 regressed benchmark
✅ 195 untouched benchmarks
⏩ 5 skipped benchmarks1

Warning

Please fix the performance issues or acknowledge them on CodSpeed.

Performance Changes

Benchmark BASE HEAD Efficiency
❌ ⚠️ build + consume 694.3 µs 777.5 µs -10.7%

Tip

Investigate this regression by commenting @codspeedbot fix this regression on this PR, or directly use the CodSpeed MCP with your agent.


Comparing Neekoras:docs-1635-untrack-async (ad4d7e4) with next (71153bf)

Open in CodSpeed

Footnotes

  1. 5 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

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