Feature request: Please add partial matching for mutation keys

[nimabrownlee]

Feature request

Description / Observed Behavior

My previous issue was completely removed for some strange reason (not even closed) so I am opening a new one. Right now if you want to use the global mutate function you have to provide a complete match with the key. It's very weird and even react-query supports partial matching. Please add it as its very crucial. I cant replicate every key in every component.

[markprins]

I have a similar situation. I'm using multiple SWRInfinites for page handling and in various configurations which hold different datasets. When certain data is updated, some of these should revalidate their data.

It would be nice to revalidate/invalidate partial keys like mutate('/toplevel/nested/*').

[DaniGuardiola]

Same! In my case I PATCH a specific item (e.g. PATCH /user/<id>) that I want to refresh on a different view with all items and pagination (e.g. GET /user?offset=20&limit=20).

[RaddishIoW]

There is a swr-mutate-many package that might help.

[nimabrownlee]

@RaddishIoW Hey, how do you use it?

I tried mutateMany('**/tasks/*', undefined, true) but it removes the task list. How can I make it just re-fetch?

[diar-kourehpaz]

@nimabrownlee Here is another way to mutate keys matching a regex:

import { mutate, cache } from 'swr'

      const pattern = /tasks/
      cache
        .keys()
        .filter((key) => pattern.test(key))
        .forEach((key) => mutate(key))

[RaddishIoW]

@nimabrownlee

I tried mutateMany('**/tasks/*', undefined, true) but it removes the task list. How can I make it just re-fetch?

Hmmm... All I do to force a re-fetch is to call mutateMany(<key>). I don't pass anything but the key.

[huozhi]

We're working on the doc for swr@beta to land the new cache API to support this feature. The current exposed cache in swr@0.x.x is not documented and highly risky to use.

There's a example section for partial mutation in that PR, feel free to give a try with swr@beta, look forward to the feedbacks.

[huozhi]

Docuement and examples are landed in cache docs

[ungarida]

The above link is out of date, this is the new one https://swr.vercel.app/docs/advanced/cache

[rjborba]

What about composite keys?
Is there a recommendation for something like:

useSwr({url, token})?

[utenma]

examples #1946