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

Skip to content

feat(watchPausable): add options.initialState to control the initial active value #4533

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 3 commits into from
Feb 12, 2025

Conversation

OrbisK
Copy link
Collaborator

@OrbisK OrbisK commented Jan 24, 2025

fixes #4515

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

This PR adds options.initalState as active or paused to pausableWatcher. This does allow starting the watcher as paused.

Additional context

@dosubot dosubot bot added size:L This PR changes 100-499 lines, ignoring generated files. enhancement New feature or request labels Jan 24, 2025
Comment on lines -80 to 287
throttleFilter(1000, true),
sumSpy,
)

let result = throttledSum(2, 3)
setTimeout(() => {
result = throttledSum(4, 5)
}, 600)
setTimeout(() => {
result = throttledSum(6, 7)
}, 900)

vi.runAllTimers()

expect(sumSpy).toHaveBeenCalledTimes(2)
await expect(result).resolves.toBe(6 + 7)

setTimeout(() => {
result = throttledSum(8, 9)
}, 1200)
setTimeout(() => {
result = throttledSum(10, 11)
}, 1800)

vi.runAllTimers()

expect(sumSpy).toHaveBeenCalledTimes(4)
await expect(result).resolves.toBe(10 + 11)
})

expect(sumSpy).toHaveBeenCalledTimes(4)
await expect(result).resolves.toBe(10 + 11)
it('should get leading value', async () => {
const sumSpy = vi.fn((a: number, b: number) => a + b)
const throttledSum = createFilterWrapper(
throttleFilter(1000, false),
sumSpy,
)

let result = throttledSum(2, 3)
setTimeout(() => {
result = throttledSum(4, 5)
}, 600)
setTimeout(() => {
result = throttledSum(6, 7)
}, 900)

vi.runAllTimers()

expect(sumSpy).toHaveBeenCalledTimes(1)
await expect(result).resolves.toBe(2 + 3)

setTimeout(() => {
result = throttledSum(8, 9)
}, 1200)
setTimeout(() => {
result = throttledSum(10, 11)
}, 1800)

vi.runAllTimers()

expect(sumSpy).toHaveBeenCalledTimes(2)
await expect(result).resolves.toBe(8 + 9)
})
})

it('should get leading value', async () => {
const sumSpy = vi.fn((a: number, b: number) => a + b)
const throttledSum = createFilterWrapper(
throttleFilter(1000, false),
sumSpy,
)

let result = throttledSum(2, 3)
setTimeout(() => {
result = throttledSum(4, 5)
}, 600)
setTimeout(() => {
result = throttledSum(6, 7)
}, 900)

vi.runAllTimers()

expect(sumSpy).toHaveBeenCalledTimes(1)
await expect(result).resolves.toBe(2 + 3)

setTimeout(() => {
result = throttledSum(8, 9)
}, 1200)
setTimeout(() => {
result = throttledSum(10, 11)
}, 1800)

vi.runAllTimers()

expect(sumSpy).toHaveBeenCalledTimes(2)
await expect(result).resolves.toBe(8 + 9)
describe('pausableFilter', () => {
it.todo('should pause')
})
Copy link
Collaborator Author

@OrbisK OrbisK Jan 24, 2025

Choose a reason for hiding this comment

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

Did not change these tests, just wrapped them in describe(filterXXX)

export function watchPausable<T extends Readonly<WatchSource<unknown>[]>, Immediate extends Readonly<boolean> = false>(sources: [...T], cb: WatchCallback<MapSources<T>, MapOldSources<T, Immediate>>, options?: WatchWithFilterOptions<Immediate>): WatchPausableReturn
export function watchPausable<T, Immediate extends Readonly<boolean> = false>(source: WatchSource<T>, cb: WatchCallback<T, Immediate extends true ? T | undefined : T>, options?: WatchWithFilterOptions<Immediate>): WatchPausableReturn
export function watchPausable<T extends object, Immediate extends Readonly<boolean> = false>(source: T, cb: WatchCallback<T, Immediate extends true ? T | undefined : T>, options?: WatchWithFilterOptions<Immediate>): WatchPausableReturn
export type WatchPausableOptions<Immediate> = WatchWithFilterOptions<Immediate> & PausableFilterOptions
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

like this?

@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Feb 12, 2025
@antfu antfu added this pull request to the merge queue Feb 12, 2025
Merged via the queue into vueuse:main with commit ceb567b Feb 12, 2025
9 checks passed
@HongJian-Yang
Copy link

perfect

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request lgtm This PR has been approved by a maintainer size:L This PR changes 100-499 lines, ignoring generated files.
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

REQUEST | watchPausable | default watch pause
3 participants