Document untrack behavior with uninitialized async reads (NotReady propagation)
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 2/5
- Tempo stimato
- 1-3 ore
- Idoneità per principianti
- 78/100
- Tipo di issue
- Documentazione
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Tranquilla
- Stack tecnologico
- javascript
- Ambito
- documentation
Direzione di ricerca
Inizia dalla pagina di riferimento di untrack collegata nell’issue e rivedi il comportamento di lettura asincrona descritto lì insieme al contesto di solidjs/solid#3007. Aggiorna la pagina per distinguere il tracciamento delle dipendenze dalla risoluzione di NotReady, spiegare la sospensione e la nuova esecuzione dell’owner e mostrare un controllo di disponibilità che non sospenda realmente usando isPending/latest.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
From solidjs/solid#3007 (reported by @mizulu).
The untrack reference page (https://v2.solidjs.com/reference/solid-js/reactivity/untrack) should document how untrack interacts with async reads in 2.0:
untrackstops dependency tracking — reads inside it do not subscribe the surrounding computation.- It does not opt out of async settlement. Reading an async source that is not yet ready inside
untrackstill throwsNotReadyError, which propagates to the owning computation: the owner suspends (participates inLoadingboundaries) and re-runs once the source first resolves.
In other words, untrack(() => getColor()) where getColor is a pending async memo will still cause the owner to re-run when getColor first settles — the read is untracked, but the not-ready suspension is part of async graph resolution, not tracking.
The page should spell out this distinction (tracking vs. settlement) and show the pattern for a genuinely non-suspending read of a possibly-pending source (e.g. checking readiness with isPending/latest as appropriate) so users aren't surprised that untrack alone doesn't provide a fallback-value escape hatch. A fallback-value overload for untrack was considered in solidjs/solid#3007 and rejected — the docs are the fix.
- Lingua principale
- MDX
- Stelle
- 292
- Fork
- 361
- Merge medio
- 7h 51m
- PR unite (30g)
- 1
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di solidjs/solid-docs
-
good first issue solid solidstart
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
solidjs/solid-docs#1522 ·
-
pending review
solidjs/solid-docs#1637 · 1 assegnatario ·
-
help wanted
solidjs/solid-docs#1636 · 5 commenti ·
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 52/100
solidjs/solid-docs#1630 · 1 commento ·
-
help wanted
solidjs/solid-docs#1593 · 4 commenti · 2 reazioni · 1 assegnatario ·
Tutte le issue di solidjs/solid-docs
Issue simili
-
Area: Excel support
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
orbeon/orbeon-forms#7893 ·
-
Theme loads third-party resources on every page (jsdelivr web font, cdnjs Font Awesome) – GDPR Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
docToolchain/docToolchain#1705 ·
-
kb-infra-drift
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
OCHA-DAP/ds-knowledge-base#653 · 1 commento ·
-
area/dev-productivity area/disaster-recovery area/ipcei kind/enhancement
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
-
Claiming namespace: rasy007 Apertanamespace operations
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
EclipseFdn/open-vsx.org#13419 ·