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#

The getWhere() method for permission provider instances has been removed in Strapi 5; use provider.values().filter() with a custom predicate instead to query and match provider items.

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'
);