Skip to content

docs(watchers): clarify watchEffect dependency re-collection - #3449

Open
smg99 wants to merge 1 commit into
vuejs:mainfrom
smg99:docs/clarify-watcheffect-dependency-recollection
Open

docs(watchers): clarify watchEffect dependency re-collection#3449
smg99 wants to merge 1 commit into
vuejs:mainfrom
smg99:docs/clarify-watcheffect-dependency-recollection

Conversation

@smg99

@smg99 smg99 commented Aug 6, 2026

Copy link
Copy Markdown

Description of Problem

watchEffect() dependency tracking wording can be misread as a fixed dependency list. The docs should clarify that dependencies are collected on each synchronous run, so branch-dependent access can change the tracked set between runs.

Proposed Solution

Update the watchEffect() tip in src/guide/essentials/watchers.md to clarify:

  • tracking happens during each synchronous run;
  • dependencies are re-collected on every re-run based on properties accessed in that run;
  • conditional branches can change the tracked dependency set between runs;
  • async effects still only track accesses before the first await tick.

Additional Information

Context: vuejs/core#13688 and vuejs/core#15212

@netlify

netlify Bot commented Aug 6, 2026

Copy link
Copy Markdown

Deploy Preview for vuejs ready!

Name Link
🔨 Latest commit bf76a77
🔍 Latest deploy log https://app.netlify.com/projects/vuejs/deploys/6a74015bf90e7600082b250b
😎 Deploy Preview https://deploy-preview-3449--vuejs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

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.

1 participant