Skip to content

Nuxt

Добавьте модуль в nuxt.config.ts, чтобы автоимпортировать все composables и зарегистрировать плагин с префиксом из runtimeConfig.

ts
// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['vue-storage-kit/nuxt'],

  storageKit: {
    prefix: 'myapp_',
    autoImports: true, // по умолчанию: true
  },
})

Блок storageKit полностью типизирован — опция неправильной формы отлавливается TypeScript прямо в редакторе, а не только в рантайме.

Опции

prefix

string

Передаётся в собственную опцию prefix плагина VueStoragePlugin.

autoImports

boolean · по умолчанию: true

Автоимпортировать глобально useStorage, useLocalStorage, useSessionStorage, useIndexedDB, useIDBRef и useCookie.

При autoImports: true следующее доступно глобально без явного импорта. useCookie здесь разрешается в SSR-совместимую runtime-версию (на базе H3 на сервере), а не в клиентскую, экспортируемую из корня пакета:

ts
useStorage()
useLocalStorage()
useSessionStorage()
useIndexedDB()
useIDBRef()
useCookie()

Оговорка про SSR: кэш экземпляров StorageEngine (по ключу target:key, общий для привязок и Vue, и React) — синглтон на уровне модуля для каждого серверного процесса, а не для каждого запроса. target: 'local' / 'session' уже закрыто откатываются к defaultValue на сервере (в Node нет window). Однако у target: 'memory'/'indexeddb' такой защиты нет, и они будут делить состояние между конкурентными запросами на одном сервере, если использовать их при SSR — избегайте этих целей для данных по-запросу/по-пользователю на сервере; они предназначены для клиентского использования.