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

Skip to content

feat(useStorage): make storage key reactive #4464

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 2 commits into from
Jan 10, 2025

Conversation

EvgenyWas
Copy link
Contributor

@EvgenyWas EvgenyWas commented Jan 5, 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

This PR makes key argument for useStorage composable reactive. It means if we change the key the data value should be taken from the appropriate key in storage, otherwise if the storage's value doesn't exist we use a default value as a new value for the data value and apply it to the storage by the new key.

Due to Vue updates flush and pausing/resuming writing to storage on the data value update in the current implementation, it requires to use nextTick after the first change if we change data and key together independently on the order. For example:

const key = ref('key')
const data = useStorage(key,  0)

// BAD: changes the key but writes to storage by new one, not old one
data.value = 1
key.value = 'new-key'

// BAD: changes the key and data according to the new storage value, but skips the data update due to the data watch pause
key.value = 'new-key'
data.value = 1

// GOOD: writes to storage by the current key and then changes the key and data appropriately
data.value = 1
await nextTick()
key.value = 'new-key'

// GOOD: changes the key and then writes to storage by the new key
key.value = 'new-key'
nextTick(() => data.value = 1)

Implements #4289

Additional context

Additionally, updated useLocalStorage and useSessionStorage types according to the new type of the useStorage key.

@EvgenyWas EvgenyWas marked this pull request as ready for review January 5, 2025 13:50
@dosubot dosubot bot added size:L This PR changes 100-499 lines, ignoring generated files. enhancement New feature or request labels Jan 5, 2025
ilyaliao
ilyaliao previously approved these changes Jan 6, 2025
@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Jan 6, 2025
@antfu antfu changed the title feat: make useStorage key reactive feat(useStorage): make storage key reactive Jan 10, 2025
@antfu antfu enabled auto-merge January 10, 2025 07:08
@antfu antfu added this pull request to the merge queue Jan 10, 2025
Merged via the queue into vueuse:main with commit eb6797a Jan 10, 2025
8 checks passed
@ineshbose
Copy link
Contributor

Hey, based on this implementation, how would you suggest if I am looking to have some key split based on a reactive value like so:

const breakpoints = useBreakpoints();
const activeBp = useComputed(() => breakpoints.active().value)
const dataForBreakpoint = useLocalStorage(() => `key-${activeBp.value}`, () => ({ [activeBp.value]: 'some value' }))

@EvgenyWas EvgenyWas deleted the feat/make-usestorage-key-reactive branch April 5, 2025 16:04
@EvgenyWas
Copy link
Contributor Author

Hey, based on this implementation, how would you suggest if I am looking to have some key split based on a reactive value like so:

Hi, you can use the getter like you wrote in your example or pass just the ref:

const breakpoints = useBreakpoints();
const activeBp = useComputed(() => breakpoints.active().value)
const dataForBreakpoint = useLocalStorage(activeBp, () => ({ [activeBp.value]: 'some value' }))

// or
const storageKey = computed(() => `key-${activeBp.value}`);
const dataForBreakpoint = useLocalStorage(storageKey, () => ({ [activeBp.value]: 'some value' }))

However, the defaults you pass with the reactive value won't change when activeBp changes.

@ineshbose
Copy link
Contributor

ineshbose commented Apr 5, 2025

Hey, based on this implementation, how would you suggest if I am looking to have some key split based on a reactive value like so:

Hi, you can use the getter like you wrote in your example or pass just the ref:

const breakpoints = useBreakpoints();

const activeBp = useComputed(() => breakpoints.active().value)

const dataForBreakpoint = useLocalStorage(activeBp, () => ({ [activeBp.value]: 'some value' }))



// or

const storageKey = computed(() => `key-${activeBp.value}`);

const dataForBreakpoint = useLocalStorage(storageKey, () => ({ [activeBp.value]: 'some value' }))

However, the defaults you pass with the reactive value won't change when activeBp changes.

Thanks! No, that's my issue is that the defaults isn't updating and rather updating the old key's value into the localStorage.. :/

so I'm wondering if I restructure my logic instead.

@EvgenyWas
Copy link
Contributor Author

so I'm wondering if I restructure my logic instead.

You can just set a new value when the value changes if it's necessary.

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.

4 participants