getResources
Returns an array or object of resources from resourceSlice
based on the filter
provided.
Arguments
resourceSlice
(Object): The slice of your state that aresourceReducer
is responsible for.filter
(Array|String|Function): The filter to apply. It can be an array of resource IDs, or the name of a list. If a function is provided, thengetResources
will iterate over the collection of resources, returning the resources that the function returns truthy for. The function will be called with three arguments:(resource, resourceMeta, resourceSlice)
. If nofilter
is provided, then all of the resources in theresourceSlice
will be returned.options
(Object): An object to customize the behavior ofgetResources
. Presently, only one option is supported:byId
. Pass{ byId true }
to receive the results as an object instead of an array.
Returns
(Array|Object
): An Array of resources, unless byId
is passed as true, in which case an object will be returned instead.
Example
import { getResources } from 'redux-resource';
import store from './store';
const state = store.getState();
// Retrieve resources by an array of IDs
const someBooks = getResources(state.books, [1, 12, 23]);
// Retrieve those same resources as an object
const someBooksAsObject = getResources(state.books, [1, 12, 23], { byId: true });
// Retrieve resources by a list name
const popularBooks = getResources(state.books, 'mostPopular');
// Retrieve the "selected" resources
const selectedBooks = getResources(state.books, (resource, meta) => meta.selected);
// Returns all resources
const allResources = getResources(state.books);
Tips
You don't always need to use this method to access resources. Just need one resource? If the resource is on a slice called
books
, you can directly access it usingstore.getState().books.resources[bookId]
.When the order of your resources doesn't matter, then it probably makes sense to pass
{ byId: true }
asoptions
so that you can look up your resources more quickly.
Last updated