import Intro from '/docs/snippets/breaking-change-page-intro.md'
import MigrationIntro from '/docs/snippets/breaking-change-page-migration-intro.md'

The getWhere() method for permission provider instances has been removed#

In Strapi 5, the getWhere() method for permission provider instances has been removed, and users should first get the provider values, then filter them.

Breaking change description#

In Strapi v4

Provider instances (action provider, condition provider, etc…) are built using a provider factory.

Those providers have a getWhere method allowing you to query provider’s items that match certain conditions and return them.

The query was an object where keys and values were matched with the provider entries:

const values = provider.getWhere({ foo: 42, bar: 'baz' });

In Strapi 5

You need to adopt a more conventional approach by first getting the provider values, then filtering them using a custom predicate:

const values = provider.values().filter(value => value.foo === 42 && value.bar === 'baz');

Migration#

Manual procedure#

Users need to manually update their code if using the getWhere() method, using the following example as a guide:

In Strapi v4

const values = provider.getWhere({ foo: 42, bar: 'baz' });

In Strapi 5

const values = provider.values().filter(
  value => value.foo === 42 && value.bar === 'baz'
);