fix: localStorage availability check update (#588)

* fix: localStorage availability check update

* Update utils.ts

fix: formatting and naming fixes

* chore: Formatting & helper function documentation

---------

Co-authored-by: Francois Best <github@francoisbest.com>

Author: iuriizaporozhets

packages/nuqs/src/debug.ts

@@ -1,9 +1,11 @@
+import { isLocalStorageAvailable } from './utils'
+
 // todo: Remove check for `next-usequerystate` in v2
 let enabled = false
 
 try {
   enabled =
-    (typeof localStorage === 'object' &&
+    (isLocalStorageAvailable() &&
       (localStorage.getItem('debug')?.includes('next-usequerystate') ||
         localStorage.getItem('debug')?.includes('nuqs'))) ||
     false

packages/nuqs/src/utils.ts

@@ -38,3 +38,22 @@ export function getDefaultThrottle() {
     return 320
   }
 }
+
+/**
+ * Check if localStorage is available.
+ *
+ * It may be unavailable in some environments, like Safari in private browsing
+ * mode.
+ * See https://github.com/47ng/nuqs/pull/588
+ */
+export function isLocalStorageAvailable() {
+  try {
+    const test = 'nuqs-localStorage-test'
+    window.localStorage.setItem(test, test)
+    const isValueAvailable = window.localStorage.getItem(test) === test
+    window.localStorage.removeItem(test)
+    return isValueAvailable
+  } catch (_) {
+    return false
+  }
+}