Error Codes Wiki

Browser IndexedDB Errors — Quota Exceeded, Blocked & Corruption

Warningweb development

Overview

Fix IndexedDB errors including QuotaExceededError, VersionError, blocked upgrades, database corruption, and private browsing limitations.

Key Details

  • IndexedDB is a client-side NoSQL database API for storing structured data in the browser
  • Storage quota varies: Chrome ~60% of free disk, Firefox 50% of free disk (per origin)
  • Private/incognito browsing may limit or disable IndexedDB (Safari clears on tab close)
  • Database version upgrades require all other connections to close first
  • Corrupted IndexedDB data requires clearing site data to resolve

Common Causes

  • QuotaExceededError: storage limit reached for the origin
  • VersionError: trying to open with a version lower than existing version
  • Blocked: another tab has an older version open and has not closed its connection
  • Database corruption from browser crash during write operation
  • Safari Private Browsing: IndexedDB works but data is ephemeral

Steps

  1. 1For QuotaExceededError: implement data cleanup — delete old entries or request more storage via Storage API
  2. 2For Blocked: implement onblocked handler and show user a message to close other tabs
  3. 3For corruption: clear site data — DevTools > Application > Storage > Clear site data
  4. 4For Safari Private: detect private browsing and show appropriate message or use fallback storage
  5. 5Request persistent storage: navigator.storage.persist() prevents browser from evicting data

Tags

browserindexeddbstoragequotadatabase

More in Web Development

Frequently Asked Questions

Chrome: up to 60% of free disk per origin (can be hundreds of GB). Firefox: 50% of free disk. Safari: starts prompting at 200MB.