`createLocalPersister`

The createLocalPersister function creates a Persister object that can persist the Store to the browser's local storage.

createLocalPersister(
  store: Store,
  storageName: string,
  onIgnoredError?: (error: any) => void,
): LocalPersister

	Type	Description
`store`	`Store`	The `Store` to persist.
`storageName`	`string`	The unique key to identify the storage location.
`onIgnoredError?`	`(error: any) => void`	An optional handler for the errors that the `Persister` would otherwise ignore when trying to save or load data. This is suitable for debugging persistence issues in a development environment, since v4.0.4.
returns	`LocalPersister`	A reference to the new `LocalPersister` object.

As well as providing a reference to the Store to persist, you must provide a storageName parameter which is unique to your application. This is the key that the browser uses to identify the storage location.

Example

This example creates a LocalPersister object and persists the Store to the browser's local storage.

const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
const persister = createLocalPersister(store, 'pets');

await persister.save();
console.log(localStorage.getItem('pets'));
// -> '[{"pets":{"fido":{"species":"dog"}}},{}]'

persister.destroy();
localStorage.clear();