fix(browser): 修复常作为顶层方法导出 的LocalStorageCache `createLocalStorageCac…

…he` `SessionStorageCache` `createSessionStorageCache` 这些方法在 ssr 环境报错的问题

.gitignore

@@ -4,18 +4,10 @@ dist
 .npmrc
 .cache
 
-packages/*/dist
-packages/*/.turbo
-
-legacy/*/dist
-legacy/*/.turbo
+dist
+.turbo
 
-!docs/.vitepress/dist
 docs/.vitepress/cache
-.local
-# local env files
-.env.local
-.env.*.local
 
 # Log files
 npm-debug.log*

packages/broswer/src/cache/localStorage.ts

@@ -1,11 +1,11 @@
-import { StorageCache, StorageCacheStoreParseType } from './storage'
+import { StorageCache, StorageCacheStoreParseType, fallbackStorage } from './storage'
 
 /**
  * localStorage缓存商店
  */
 export class LocalStorageCache<T = any> extends StorageCache<T> {
   constructor(key: string, parse?: StorageCacheStoreParseType<T> | true) {
-    super(window.localStorage, key, parse)
+    super(window?.localStorage || fallbackStorage, key, parse)
   }
 }
 

packages/broswer/src/cache/sessionStorage.ts

@@ -1,11 +1,11 @@
-import { StorageCache, StorageCacheStoreParseType } from './storage'
+import { StorageCache, StorageCacheStoreParseType, fallbackStorage } from './storage'
 
 /**
  * sessionStorage缓存商店
  */
 export class SessionStorageCache<T = any> extends StorageCache<T> {
   constructor(key: string, parse?: StorageCacheStoreParseType<T> | true) {
-    super(window.sessionStorage, key, parse)
+    super(window?.sessionStorage || fallbackStorage, key, parse)
   }
 }
 

packages/broswer/src/cache/storage.ts

@@ -18,6 +18,23 @@ const JSONStorageCacheStoreParse = {
   set: (value) => JSON.stringify(value),
 }
 
+/**
+ * 一个如果当前平台不存在 `Storage` 的实现时的，后备选项
+ * 主要为了兼容 ssr
+ */
+export const fallbackStorage: Storage = {
+  length: 0,
+  clear() {},
+  getItem() {
+    return null
+  },
+  key() {
+    return null
+  },
+  removeItem() {},
+  setItem() {},
+}
+
 /**
  * Storage缓存商店
  * 提供自动json数据处理功能