Document untrack behavior with uninitialized async reads (NotReady propagation)
Personne n'a encore pris cette issue.
- Langage dominant
- MDX
- Étoiles
- 292
- Forks
- 361
- Merge moyen
- 7 h 51 min
- PR mergées (30 j)
- 1
Description
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.
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez par la page de référence de untrack liée dans l’issue et examinez le comportement de lecture asynchrone qui y est décrit avec le contexte de solidjs/solid#3007. Mettez à jour la page afin de distinguer le suivi des dépendances du règlement de NotReady, d’expliquer la suspension et la nouvelle exécution de l’owner, et de montrer une vérification de disponibilité qui ne provoque réellement pas de suspension avec isPending/latest.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- javascript
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Activité
- Calme
- Clarté
- Clairement spécifiée
- Accessibilité débutants
- 78/100