feat(core): async useComputed$ by wmertens · Pull Request #8807 · QwikDev/qwik

wmertens · 2026-07-07T20:57:25Z

This PR deprecates useAsync$ and instead moves all async the machinery to ComputedSignal.

This means that the synchronous part of the compute function gets reactive-tracked automatically, and after the first await, track() needs to be used.

changeset-bot · 2026-07-07T20:57:29Z

🦋 Changeset detected

Latest commit: 3672ae5

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages

Name	Type
@qwik.dev/core	Major
@qwik.dev/router	Major
eslint-plugin-qwik	Major
@qwik.dev/react	Major
create-qwik	Major

Not sure what this means? Click here to learn what changesets are.

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

Copilot

Pull request overview

This PR extends Qwik core’s computed signals to support async compute functions, deprecating useAsync$/createAsync$ and moving the async-signal machinery (pending/error state, jobs, polling, cleanup, serialization behavior) into ComputedSignalImpl. It also updates Qwik Router loader signals to use ComputedSignal, refreshes docs and API outputs to reflect the new async useComputed$ behavior, and updates e2e snapshots/budgets accordingly.

Changes:

Add async support to useComputed$/createComputed$ and unify async-signal behavior into ComputedSignalImpl (with .pending, .error, .promise(), polling, etc.).
Deprecate useAsync$/createAsync$ and migrate router loaders and docs examples from AsyncSignal/.loading to ComputedSignal/.pending.
Update serialization/resume paths and SSG snapshot/budget expectations for the new signal engine behavior.

Reviewed changes

Copilot reviewed 69 out of 69 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/qwik/src/core/use/use-resource.ts	Switch `ResourceCtx` to extend `ComputeCtx`.
packages/qwik/src/core/use/use-computed.ts	Update computed hook types/docs for async compute functions and `ComputeCtx`.
packages/qwik/src/core/use/use-async.ts	Deprecate `useAsync$` and switch ctx type to `ComputeCtx`.
packages/qwik/src/core/tests/use-resource.spec.tsx	Adjust resource test timing to accommodate new scheduling behavior.
packages/qwik/src/core/tests/use-computed.spec.tsx	Replace “promise disallowed” test with async-computed behavior tests.
packages/qwik/src/core/tests/use-async.spec.tsx	Update tests for `.pending`/internal field renames and new typing shape.
packages/qwik/src/core/ssr/ssr-render-jsx.ts	Treat computed signals as the relevant async/polling signal type for eager resume.
packages/qwik/src/core/shared/serdes/serialize.ts	Serialize async-mode computeds based on flags (not `instanceof`), and handle errored async mode.
packages/qwik/src/core/shared/serdes/serdes.unit.ts	Update serialization unit snapshots/expectations for new async-mode computed serialization.
packages/qwik/src/core/shared/serdes/inflate.ts	Update inflate logic to use $untrackedPending$ instead of $untrackedLoading$ .
packages/qwik/src/core/shared/error/error.ts	Clear Q29 text since async computed is now supported.
packages/qwik/src/core/reactive-primitives/types.ts	Introduce `ComputeCtx`, expand `ComputedOptions<T>` to include async-signal options, add new async flags.
packages/qwik/src/core/reactive-primitives/signal.public.ts	Unify async API onto `ComputedSignal` (`pending`, error, promise, etc.), deprecate `AsyncSignal` as an alias.
packages/qwik/src/core/reactive-primitives/signal-api.ts	Update `createComputedSignal` signature to accept `ComputedFn<T>` and typed `ComputedOptions<T>`.
packages/qwik/src/core/reactive-primitives/internal-api.ts	Update signal-impl checks from `AsyncSignalImpl` to `ComputedSignalImpl`.
packages/qwik/src/core/reactive-primitives/impl/computed-signal-impl.ts	Core change: embed async engine state/behavior in `ComputedSignalImpl` and add async-computed execution semantics.
packages/qwik/src/core/reactive-primitives/impl/async-signal.unit.tsx	Update unit tests to stop depending on `AsyncCtx` typing and reflect new ctx shape.
packages/qwik/src/core/reactive-primitives/impl/async-signal-impl.ts	Reduce `AsyncSignalImpl` to a thin wrapper configuring flags/options; move engine logic to `ComputedSignalImpl`.
packages/qwik/src/core/reactive-primitives/impl/async-computed.unit.tsx	New unit coverage for async computed behavior: pending/error, tracking rules, previous/info, cleanup, options.
packages/qwik/src/core/reactive-primitives/cleanup.ts	Ensure cleanup removes pending/error subscriptions for computeds carrying async state.
packages/qwik/src/core/qwik.core.api.md	Update extracted core API docs for async `useComputed$`, deprecated async APIs, and new signal surface.
packages/qwik/src/core/client/vnode-diff.ts	Update cleanup logic to treat async-mode computeds as destroyable (similar to previous async-signal cleanup).
packages/qwik-router/src/runtime/src/types.ts	Refine action option typing (introduce `ActionOptions` and expand constructor overloads).
packages/qwik-router/src/runtime/src/server-functions.unit.ts	Add a type-level regression for `routeAction$` invalidate typing without validators.
packages/qwik-router/src/runtime/src/route-loaders.ts	Switch loader signals from `createAsync$` to async `createComputed$` and update injected-value tracking notes.
packages/qwik-router/src/runtime/src/qwik-router.runtime.api.md	Update router API docs to reference `ComputedSignal` and new `ActionOptions`.
packages/qwik-router/src/runtime/src/qwik-router-component.tsx	Switch runtime loader state to `ComputedSignal` and update pending-trigger reads.
packages/qwik-router/src/runtime/src/index.ts	Export `ActionOptions`.
packages/qwik-router/src/runtime/src/head.ts	Update head resolution types to use `ComputedSignal`.
packages/qwik-router/ARCHITECTURE.md	Update documentation to refer to `.untrackedPending` for loader signal triggering.
packages/docs/src/routes/tutorial/reactivity/resource/solution/app.tsx	Migrate tutorial solution from `useAsync$` to async `useComputed$` and `.pending`.
packages/docs/src/routes/tutorial/reactivity/resource/problem/app.tsx	Migrate tutorial problem from `useAsync$` to async `useComputed$` and `.pending`.
packages/docs/src/routes/tutorial/reactivity/resource/index.mdx	Update tutorial copy/snippets from `useAsync$` to async `useComputed$`.
packages/docs/src/routes/tutorial/introduction/resource/solution/app.tsx	Migrate intro tutorial solution to async `useComputed$` and `.pending`.
packages/docs/src/routes/tutorial/introduction/resource/problem/app.tsx	Migrate intro tutorial problem to async `useComputed$` and `.pending`.
packages/docs/src/routes/tutorial/introduction/resource/index.mdx	Update intro tutorial narrative/examples to async `useComputed$` and `.pending`.
packages/docs/src/routes/examples/apps/reactivity/auto-complete/app.tsx	Update example from `useAsync$` to async `useComputed$`.
packages/docs/src/routes/examples/apps/partial/hackernews-index/app.tsx	Update example from `useAsync$` to async `useComputed$` and `.pending`.
packages/docs/src/routes/docs/upgrade/index.mdx	Update upgrade guide to explain async `useComputed$` and migration away from `useAsync$`.
packages/docs/src/routes/docs/labs/suspense/index.mdx	Update Suspense docs to use async `useComputed$` and `.pending`.
packages/docs/src/routes/docs/errors/index.mdx	Mark Q29 as no longer used; update clientOnly SSR guidance to `.pending`.
packages/docs/src/routes/docs/(qwikrouter)/route-loader/index.mdx	Update route loader docs to `ComputedSignal` + `.pending` terminology.
packages/docs/src/routes/docs/(qwikrouter)/guides/best-practices/index.mdx	Update best-practices guidance to use async `useComputed$` instead of `useAsync$`.
packages/docs/src/routes/docs/(qwik)/getting-started/index.mdx	Add/describe `invalidate` option in action examples.
packages/docs/src/routes/docs/(qwik)/core/tasks/index.mdx	Update guidance from `useAsync$` to async `useComputed$`.
packages/docs/src/routes/docs/(qwik)/core/state/index.mdx	Replace `useAsync$` section with “async computed values” guidance and migration note.
packages/docs/src/routes/docs/(qwik)/core/overview/index.mdx	Update overview bullets to reflect async `useComputed$` and remove `useAsync$`.
packages/docs/src/routes/demo/state/async-joke/index.tsx	Migrate demo from `useAsync$` to async `useComputed$`.
packages/docs/src/routes/demo/getting-started/06-styling/index.tsx	Update demo action example to include `invalidate`.
packages/docs/src/routes/demo/getting-started/05-tasks/index.tsx	Update demo action example to include `invalidate`.
packages/docs/src/routes/demo/getting-started/04-state/index.tsx	Update demo action example to include `invalidate`.
packages/docs/src/routes/demo/getting-started/03-posting-data/index.tsx	Update demo action example to include `invalidate`.
packages/docs/src/routes/demo/component/suspense-async/index.tsx	Update suspense demo from `useAsync$` to async `useComputed$`.
packages/docs/src/routes/api/qwik/api.json	Update generated API JSON for deprecated async APIs and expanded computed signal API surface.
packages/docs/src/routes/api/qwik-router/index.mdx	Update generated router API docs to `ActionOptions` and `ComputedSignal` loader signal shape.
packages/docs/src/routes/api/qwik-router/api.json	Update generated router API JSON to include `ActionOptions` and new loader-signal pick set.
e2e/qwik-e2e/tests/qwikrouter/ssg-snapshot.e2e.ts	Bump core brotli budget to account for computed async engine move.
e2e/qwik-e2e/tests/qwikrouter/nav.e2e.ts	Strengthen nav assertions to ensure loader-driven content is visible after navigation.
e2e/qwik-e2e/apps/qwikrouter-ssg-snapshot/expected.state.txt	Update SSG serialized state golden to match new signal engine serialization layout.
e2e/qwik-e2e/apps/qwikrouter-ssg-snapshot/expected.ssg.html	Update SSG HTML golden to match new preload list/output.
.ruler/skills/qwik-e2e-verification/SKILL.md	Document SSG snapshot suite traps and regeneration behavior.
.ruler/skills/qwik-core-development/references/core-notes.md	Update core notes to reflect async engine move and new invariants (flags vs class identity).
.codex/skills/qwik-e2e-verification/SKILL.md	Regenerated skill output mirroring the updated `.ruler` source.
.codex/skills/qwik-core-development/references/core-notes.md	Regenerated skill output mirroring the updated `.ruler` source.
.claude/skills/qwik-e2e-verification/SKILL.md	Regenerated skill output mirroring the updated `.ruler` source.
.claude/skills/qwik-core-development/references/core-notes.md	Regenerated skill output mirroring the updated `.ruler` source.
.changeset/route-action-invalidate-types.md	Changeset for router type-level fix around action invalidation typing.
.changeset/async-computed.md	Changeset for core feature: async `useComputed$` and async API deprecations.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

pkg-pr-new · 2026-07-07T21:05:07Z

Open in StackBlitz

@qwik.dev/core

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/core@8807

@qwik.dev/router

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/router@8807

eslint-plugin-qwik

npm i https://pkg.pr.new/QwikDev/qwik/eslint-plugin-qwik@8807

create-qwik

npm i https://pkg.pr.new/QwikDev/qwik/create-qwik@8807

@qwik.dev/optimizer

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/optimizer@8807

@qwik.dev/devtools

npm i https://pkg.pr.new/QwikDev/qwik/@qwik.dev/devtools@8807

commit: d724737

github-actions · 2026-07-07T21:12:25Z

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name	Status	Preview	Last Commit
qwik-docs	✅ Ready (View Log)	Visit Preview	`3672ae5`

Varixo · 2026-07-09T15:35:12Z

I dont quite like that. The implementation is really loooong, even if someone is not using features, they need to download all the code, can we do it more tree shakeable? 🤔

It's 200 brotli bytes more for the router e2e build hmmm.

Well, we can't determine if the result is a Promise at build time, and making the async machinery lazy loaded dependent on that requires overhauling the core build and that's definitely a different PR.

…r + docs fixes

useComputed$ now accepts async functions again. Reactive reads before the first `await` are auto-tracked, and later reads need the ComputeCtx track(). The AsyncSignal engine moves into ComputedSignalImpl.

Add a qwik-e2e-verification note on the two independent SSG snapshot assertion types (serialized goldens vs bundle-size budgets) and the update-does-not-fix-budgets / exit-1 traps. Regenerate committed skill outputs.

- reading .error triggers the compute if needed - synchronous throws also populate .error

wmertens · 2026-07-11T17:12:59Z

@copilot resolve the merge conflicts in this pull request

Copilot · 2026-07-11T17:15:33Z

@copilot resolve the merge conflicts in this pull request

Resolved the merge conflict in e2e/qwik-e2e/tests/qwikrouter/nav.e2e.ts (commit d72473743). The single conflict combined:

Our branch's price text assertions (Price: $21.96 / Price: $48.96)
Base branch's navigation status checks (idle/navigating) and the async click-intercept mechanism

Both sets of checks are preserved in the merged result.

also move the use-async tests to use-computed.

feat(core): async useComputed$

wmertens requested a review from a team as a code owner July 7, 2026 20:57

Copilot AI review requested due to automatic review settings July 7, 2026 20:57

wmertens requested review from a team as code owners July 7, 2026 20:57

maiieul assigned wmertens Jul 7, 2026

maiieul added this to Qwik Development Jul 7, 2026

maiieul moved this to Waiting For Review in Qwik Development Jul 7, 2026

Copilot started reviewing on behalf of wmertens July 7, 2026 20:57

View session

wmertens force-pushed the drop-useAsync branch from d4cf4b4 to cfcc516 Compare July 7, 2026 21:01

Copilot AI reviewed Jul 7, 2026

View reviewed changes

wmertens force-pushed the drop-useAsync branch from cfcc516 to d97eb03 Compare July 7, 2026 21:22

Varixo reviewed Jul 9, 2026

View reviewed changes

wmertens added 4 commits July 10, 2026 19:47

fix(router): routeAction options type can invalidate without validato…

7227b53

…r + docs fixes

feat(core): async useComputed$

96fe9e1

useComputed$ now accepts async functions again. Reactive reads before the first `await` are auto-tracked, and later reads need the ComputeCtx track(). The AsyncSignal engine moves into ComputedSignalImpl.

docs(core): deprecate/remove AsyncSignal API

df64383

docs(guidance): SSG snapshots

7bb46a3

Add a qwik-e2e-verification note on the two independent SSG snapshot assertion types (serialized goldens vs bundle-size budgets) and the update-does-not-fix-budgets / exit-1 traps. Regenerate committed skill outputs.

wmertens force-pushed the drop-useAsync branch from d97eb03 to 4a417eb Compare July 10, 2026 18:46

fix(core): reading computed.error does lazy exec

4917019

- reading .error triggers the compute if needed - synchronous throws also populate .error

wmertens force-pushed the drop-useAsync branch from 4a417eb to 4917019 Compare July 11, 2026 16:22

Copilot started work on behalf of wmertens July 11, 2026 17:13

View session

chore: merge build/v2 into drop-useAsync

d724737

Copilot finished work on behalf of wmertens July 11, 2026 17:15

wmertens added 2 commits July 12, 2026 22:28

fix(core): indirect clientOnly subscriptions

b5a74df

fix(core): clientOnly computed$

3672ae5

also move the use-async tests to use-computed.

wmertens merged commit 5c6a303 into build/v2 Jul 12, 2026
46 of 47 checks passed

wmertens deleted the drop-useAsync branch July 12, 2026 20:40

github-project-automation Bot moved this from Waiting For Review to Done in Qwik Development Jul 12, 2026

wmertens mentioned this pull request Jul 12, 2026

[🐞] [V2] useAsync$ with clientOnly option, has issues with it(?) #8659

Closed

github-actions Bot mentioned this pull request Jul 12, 2026

V2 Version Packages (beta) #8723

Merged

AmariahAK pushed a commit to AmariahAK/qwik that referenced this pull request Jul 13, 2026

Merge pull request QwikDev#8807 from QwikDev/drop-useAsync

be1908a

feat(core): async useComputed$

AmariahAK pushed a commit to AmariahAK/qwik that referenced this pull request Jul 13, 2026

Merge pull request QwikDev#8807 from QwikDev/drop-useAsync

cc8afa2

feat(core): async useComputed$

Navigation Menu

Repository navigation

feat(core): async useComputed$ - #8807

feat(core): async useComputed$#8807
wmertens merged 8 commits into
build/v2from
drop-useAsync

wmertens commented Jul 7, 2026

Uh oh!

changeset-bot Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pkg-pr-new Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 7, 2026 •

edited

Loading

Uh oh!

Uh oh!

Varixo Jul 9, 2026

Uh oh!

wmertens Jul 10, 2026 •

edited

Loading

Uh oh!

wmertens Jul 10, 2026

Uh oh!

wmertens commented Jul 11, 2026

Uh oh!

Copilot AI commented Jul 11, 2026

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

wmertens commented Jul 7, 2026

Uh oh!

changeset-bot Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pkg-pr-new Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Uh oh!

Uh oh!

Varixo Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

wmertens Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

wmertens Jul 10, 2026

Choose a reason for hiding this comment

Uh oh!

wmertens commented Jul 11, 2026

Uh oh!

Copilot AI commented Jul 11, 2026

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

changeset-bot Bot commented Jul 7, 2026 •

edited

Loading

pkg-pr-new Bot commented Jul 7, 2026 •

edited

Loading

github-actions Bot commented Jul 7, 2026 •

edited

Loading

wmertens Jul 10, 2026 •

edited

Loading