mozilla/localForage
LocalForage
localForage is a browser storage wrapper and key-value store that provides a unified JavaScript API for persisting data. It acts as an abstraction layer over IndexedDB, WebSQL, and localStorage, allowing web applications to save data offline.
The library features a priority-based driver fallback system that automatically detects and selects the most capable storage engine available in the browser. It simplifies data management by providing an asynchronous interface for storing complex JavaScript objects and binary buffers without requiring manual serialization.
The project covers broad capability areas including browser client-side storage, IndexedDB management, and the creation of isolated storage instances to keep data sets separate. It also supports the implementation of custom storage drivers to control how data is physically written and read.
Features
- Storage Abstraction - Provides a unified storage abstraction layer that wraps disparate browser storage APIs into a single consistent interface.
- Browser Storage Managers - Acts as a browser storage manager providing a unified API for IndexedDB, WebSQL, and localStorage.
- Client-Side Storage - Provides a comprehensive solution for client-side storage in browser environments using a unified API.
- Complex Data Serialization - Provides complex data serialization for native JavaScript objects and binary buffers.
- Transparent - Automatically handles the serialization and deserialization of JavaScript objects and binary buffers for storage.
- Transparent JavaScript - Saves native JavaScript objects and binary buffers to browser storage without manual string conversion.
- Key-Value Persistence Stores - Provides a key-value persistence store in the browser with automatic fallback for compatibility.
- Key-Value Stores - Implements a lightweight key-value store for persisting application state in the browser.
- Offline-First Persistence - Enables offline-first persistence by automatically selecting the best available local storage mechanism.
- Storage Engine Fallbacks - Automatically selects the most capable storage engine and reverts to simpler alternatives via a priority-based fallback system.
- Storage Abstraction Layers - Implements a storage abstraction layer that decouples application logic from specific browser storage engines.
- IndexedDB Stores - Simplifies IndexedDB store management by providing an easier asynchronous API for complex objects.
- Pluggable Storage Drivers - Features a pluggable architecture that allows developers to inject custom storage drivers for data persistence.
- Custom Storage Adapters - Allows the definition of custom storage adapters to control the physical writing and reading of data.
- Promise-Based API Wrappers - Provides a promise-based API wrapper that converts legacy storage callbacks into a modern asynchronous flow.
- Offline Web Applications - Provides the architectural persistence layer required for offline web applications to retain information.
- Client-Side Storage - Offline storage wrapper for IndexedDB, WebSQL, and LocalStorage.
- Web Components and UI - Consistent interface for offline storage using IndexedDB or WebSQL.
