Thanks to visit codestin.com
Credit goes to github.com

Skip to content

feat(watchOnce): use vue's native once behaviour #4750

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 14, 2025
Merged

Conversation

ferferga
Copy link
Member

@ferferga ferferga commented May 13, 2025

Before submitting the PR, please make sure you do the following

  • Read the Contributing Guidelines.
  • Read the Pull Request Guidelines.
  • Check that there isn't already a PR that solves the problem the same way to avoid creating a duplicate.
  • Provide a description in this PR that addresses what the PR is solving, or reference the issue that it solves (e.g. fixes #123).
  • Ideally, include relevant tests that fail without this PR but pass with it.
⚠️ Slowing down new functions

Warning: Slowing down new functions

As the VueUse audience continues to grow, we have been inundated with an overwhelming number of feature requests and pull requests. As a result, maintaining the project has become increasingly challenging and has stretched our capacity to its limits. As such, in the near future, we may need to slow down our acceptance of new features and prioritize the stability and quality of existing functions. Please note that new features for VueUse may not be accepted at this time. If you have any new ideas, we suggest that you first incorporate them into your own codebase, iterate on them to suit your needs, and assess their generalizability. If you strongly believe that your ideas are beneficial to the community, you may submit a pull request along with your use cases, and we would be happy to review and discuss them. Thank you for your understanding.


Description

Updates watchOnce logic to match shortcut watchers like watchImmediate, so it works as a pure shortcut to Vue's native once watchers feature.

Additional context

@antfu This requires Vue 3.4, so technically this is a breaking change for users pre-Vue 3.4. Shall we support users staying behind or users are expected to always be in the latest version? According to our semver range, Vue 3.5 is the only supported version, but I don't know if this is intended or not.

@dosubot dosubot bot added the size:M This PR changes 30-99 lines, ignoring generated files. label May 13, 2025
Comment on lines +29 to 38
export function watchOnce<T = any>(source: T, cb: any, options?: Omit<WatchOptions, 'once'>) {
return watch(
source as any,
cb,
{
...options,
once: true,
},
)
}
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
export function watchOnce<T = any>(source: T, cb: any, options?: Omit<WatchOptions, 'once'>) {
return watch(
source as any,
cb,
{
...options,
once: true,
},
)
}
export function watchOnce<T = any, Immediate extends Readonly<boolean> = false>(source: T | WatchSource<T>, cb: any, options?: Omit<WatchOptions<Immediate>, 'once'>) {
return watch(
source,
cb,
{
...options,
once: true,
},
)
}

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@OrbisK Why? To keep compat?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah, and to be as close as possible to native watch

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@OrbisK Shall we do the same with the other watch shortcuts I guess.

I wonder as well why we don't do rest parameters and typeof watch (with a tail-like helper like the ones in type-fest to overwrite just the last parameter) so we don't have to keep this up to date ever...

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we can do, but does this work with the generics and overloads?

@antfu
Copy link
Member

antfu commented May 14, 2025

Yes we are requiring 3.5.0+, so it should be fine to do this

@antfu antfu changed the title refactor(watchOnce): use vue's native once behaviour feat(watchOnce): use vue's native once behaviour May 14, 2025
@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label May 14, 2025
@antfu antfu added this pull request to the merge queue May 14, 2025
Merged via the queue into main with commit 08f7dc4 May 14, 2025
8 checks passed
@antfu antfu deleted the vue-native-watchOnce branch May 14, 2025 04:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
lgtm This PR has been approved by a maintainer size:M This PR changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants