API Documentation / pinia / DefineStoreOptions

Interface: DefineStoreOptions<Id, S, G, A>

pinia.DefineStoreOptions

Options parameter of defineStore() for option stores. Can be extended to augment stores with the plugin API. @see DefineStoreOptionsBase.

Type parameters

NameType
Idextends string
Sextends StateTree
GG
AA

Hierarchy

Properties

actions

Optional actions: A & ThisType<A & UnwrapRef<S> & _StoreWithState<Id, S, G, A> & _StoreWithGetters<G> & PiniaCustomProperties<string, StateTree, _GettersTree<StateTree>, _ActionsTree>>

Optional object of actions.

Defined in

pinia/src/types.ts:654


getters

Optional getters: G & ThisType<UnwrapRef<S> & _StoreWithGetters<G> & PiniaCustomProperties<string, StateTree, _GettersTree<StateTree>, _ActionsTree>> & _GettersTree<S>

Optional object of getters.

Defined in

pinia/src/types.ts:647


id

id: Id

Unique string key to identify the store across the application.

Defined in

pinia/src/types.ts:636

Methods

hydrate

Optional hydrate(storeState, initialState): void

Allows hydrating the store during SSR when complex state (like client side only refs) are used in the store definition and copying the value from pinia.state isn't enough.

example If in your state, you use any customRefs, any computeds, or any refs that have a different value on Server and Client, you need to manually hydrate them. e.g., a custom ref that is stored in the local storage:

const useStore = defineStore('main', {
  state: () => ({
    n: useLocalStorage('key', 0)
  }),
  hydrate(storeState, initialState) {
    // @ts-expect-error: https://github.com/microsoft/TypeScript/issues/43826
    storeState.n = useLocalStorage('key', 0)
  }
})

Parameters

NameTypeDescription
storeStateUnwrapRef<S>the current state in the store
initialStateUnwrapRef<S>initialState

Returns

void

Defined in

pinia/src/types.ts:687


state

Optional state(): S

Function to create a fresh state. Must be an arrow function to ensure correct typings!

Returns

S

Defined in

pinia/src/types.ts:642