feat(useRouteQuery, useRouteHash): add preserveHash/preserveQuery option

[jeongtae]

Description

In the current version, updating the query will lose the hash and vice versa.

const query = useRouteQuery('q')
const hash = useRouteHash()
query = 'foo' // http://some.url/?q=foo
hash.value = 'bar' // http://some.url/#bar  *query is removed*

This PR enables the following approach:

const hashPreservesQuery = useRouteHash(undefined, { preserveQuery: true })
query.value = 'foo' // http://some.url/?q=foo
hashPreservesQuery.value = 'bar' // http://some.url/?q=foo#bar

Additional context

vue-router removes a query(or hash) unless explicitly specified. The maintainer said it is intentional behavior. (vuejs/vue-router#2868)
But since these hooks abstract vue-router push/replace, I thought it should be able to preserve a query/hash via options.

I'm not good at English. Any comments about English grammar on JSDocs are welcome.

Thanks for providing nice hooks.

---

What is the purpose of this pull request?

• Bug fix
• New Feature
• Documentation update
• Other

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.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[mercmobily]

Is this not going to be merged?

[jeongtae]

@mercmobily

This was addressed in PR #2350 via a different method.

And it was deployed in v9.4.0, so if you're experiencing issues like the one in the text, I recommend upgrading your library version.

[mercmobily]

Thank you and sorry for the noise

…

On Sun, 17 Mar 2024, 4:14 am Dylan (Jeongtae Kim), ***@***.***> wrote: @mercmobily <https://github.com/mercmobily> This was addressed in PR #2350 <#2350> via a different method. And it was deployed in v9.4.0, so if you're experiencing issues like the one in the text, I recommend upgrading your library version. — Reply to this email directly, view it on GitHub <#2107 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAQHWXQGRIOPBCKUOHF4F53YYUDBVAVCNFSM57D6S67KU5DIOJSWCZC7NNSXTN2JONZXKZKDN5WW2ZLOOQ5TEMBQGIZDSMBYHE3Q> . You are receiving this because you were mentioned.Message ID: ***@***.***>