Skip to content
Перевод синхронизирован с документацией от , хэш коммита 59ec609.

Документация API / pinia / DefineStoreOptions

Интерфейс: DefineStoreOptions<Id, S, G, A>

pinia.DefineStoreOptions

Параметр options функции defineStore() для создания option-хранилищ. Может быть расширен для дополнения хранилищ с использованием API плагинов.

Смотрите

DefineStoreOptionsBase.

Параметры типа

НазваниеТип
Idextends string
Sextends StateTree
GG
AA

Иерархия

Свойства

actions

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

Опциональный объект действий.


getters

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

Опциональный объект геттеров.


id

id: Id

Уникальный строковый ключ для идентификации хранилища в приложении.


state

Опционально state: () => S

Функция для создания нового состояния. Должна быть стрелочной функцией для обеспечения правильной типизации!

Объявление типа

▸ (): S

Возвращает

S

Методы

hydrate

hydrate(storeState, initialState): void

Позволяет гидратировать хранилище во время SSR, когда в определении хранилища используются сложное состояние (например, только ref-ссылки на стороне клиента) и копирования значения из pinia.state будет недостаточно.

Параметры

НазваниеТипОписание
storeStateUnwrapRef<S>текущее состояние хранилища
initialStateUnwrapRef<S>initialState

Возвращает

void

Пример

Если в вашем state вы используете любые customRef, computed или ref, значения которых различаются на сервере и клиенте, вам нужно будет вручную их гидратировать (восстановить). Например, ref-ссылка, которая хранится в локальном хранилище:

ts
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)
  }
})

Released under the MIT License.