diff --git a/docs/src/api/class-browsercontext.md b/docs/src/api/class-browsercontext.md
index 0da156b664..797786afac 100644
--- a/docs/src/api/class-browsercontext.md
+++ b/docs/src/api/class-browsercontext.md
@@ -1533,6 +1533,10 @@ Whether to emulate network being offline for the browser context.
 
 Returns storage state for this browser context, contains current cookies, local storage snapshot and IndexedDB snapshot.
 
+:::note
+IndexedDBs with typed arrays are currently not supported.
+:::
+
 ## async method: BrowserContext.storageState
 * since: v1.8
 * langs: csharp, java
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index 6f7c35e361..cc77a1f4fc 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -9268,6 +9268,9 @@ export interface BrowserContext {
   /**
    * Returns storage state for this browser context, contains current cookies, local storage snapshot and IndexedDB
    * snapshot.
+   *
+   * **NOTE** IndexedDBs with typed arrays are currently not supported.
+   *
    * @param options
    */
   storageState(options?: {