IndexedDB est une API de bas niveau qui permet le stockage côté client de quantités importantes de données structurées, incluant des fichiers/blobs. Cette API utilise des index afin de permettre des recherches performantes sur ces données. Alors que Web Storage est utile pour stocker de petites quantités de données, il est moins utile pour stocker de grandes quantités de données structurées. IndexedDB fournit une solution. Cette page est le point d'entrée pour tout ce qui concerne IndexedDB sur MDN - vous y trouverez les liens vers la référence complète de l'API et les guides d'utilisation, le support par les navigateurs, et quelques explications des concepts clés.
Note : Cette fonctionnalité est disponible via les Web Workers.
Note : L'API IndexedDB est puissante, mais elle peut sembler trop compliquée dans les cas simples. Si vous préferez une API plus simple, essayez des librairies comme localForage, dexie.js, ZangoDB, PouchDB, idb, idb-keyval, JsStore et lovefield qui offrent de nombreux avantages aux développeurs de IndexedDB.
Concepts clés et utilisationIndexedDB est un système de gestion de base de données transactionnel, similaire à un SGBD relationnel basé sur SQL. Cependant contrairement aux SGBD relationnels, qui utilisent des tables avec des colonnes fixes, IndexedDB est une base de données orientée objet basée sur JavaScript. IndexedDB vous permet de stocker et de récupérer des objets qui sont indexés avec une clef; tout objet supporté par l'algorithme de clônage structuré peut être stocké. Vous devez spécifier le schéma de la base de données, ouvrir une connexion à votre base de données, puis récupérer et mettre à jour des données dans une série de transactions.
Note : Comme la plupart des solutions de stockage en ligne, IndexedDB suit la politique same-origin policy. Alors même que vous pouvez accèder à des données stockées au sein d'un domaine, vous ne pouvez pas accéder à des données sur plusieurs domaines.
Synchrone et asynchroneLes opérations effectuées par IndexedDB sont réalisées de manière asynchrone, afin de ne pas bloquer l'application. IndexedDB comprend à la fois une API asynchrone et une API synchrone. L'API synchrone était à l'origine uniquement destinée pour un usage avec les Web workers, mais elle a été retirée de la spécification parce qu'il était difficile de savoir si elle était nécessaire. Cependant l'API synchrone pourrait être ré-integrée si il y a une demande suffisante de la part des développeurs web.
Limites de stockage et critères d'évictionIl y a un certain nombre de technologies web pour stocker différents types de données côté client (par exemple, sur votre disque local). IndexedDB est la plus couramment citée. Le processus par lequel le navigateur calcule combien d'espace il doit allouer aux données web, et ce qu'il doit supprimer quand la limite est atteinte, n'est pas simple et varie entre les différents navigateurs. L'article Limites de stockage du navigateur et critères d'éviction tente d'expliquer ce fonctionnement, au moins pour le cas de Firefox.
InterfacesPour accèder à une base de données, il faut apeller open() sur l'attribut indexedDB d'un objet window. Cette méthode retourne un objet IDBRequest; Les opérations asynchrones communiquent avec l'application appelante en déclenchant des évènements sur les objets IDBRequest.
IDBEnvironment
Fournit un accès aux fonctionnalités d'IndexedDB. Implémenté par les objets window et worker.
IDBFactory
Fournit un accès à la base de données.C'est l'interface implémentée par l'objet global indexedDB et c'est donc le point d'entrée de l'API.
IDBOpenDBRequest
Représente une requête d'ouverture de la base de données.
IDBDatabase
Représente une connexion à la base de données. C'est le seul moyen d'obtenir une transaction sur la base de données.
IDBTransaction
Représente une transaction. Vous créez une transaction sur la base de données, spécifiez la portée (comme à quel magasin d'objets vous souhaitez accèder), et déterminez le type d'accès désiré (lecture seule ou lecture et écriture).
IDBRequest
Interface générique qui récupère les requêtes à la base de données et fournit un accès aux résultats.
IDBObjectStore
Représente un magasin d'objets qui permet l'accès à un ensemble de données d'une base de données IndexedDB, recherché par clé primaire.
IDBIndex
Permet aussi d'accèder à un sous-ensemble de données d'une base IndexedDB mais utilise un index pour récupérer les enregistrements, au lieu d'une clé primaire. C'est parfois plus rapide qu'un usage de IDBObjectStore.
IDBCursor
Itérateur sur les magasins d'objets et les index.
IDBCursorWithValue
Itérateur sur les magasins d'objets et les index et retourne la valeur courante du curseur.
IDBKeyRange
Définit une portée de valeurs qui peut être utilisée pour récupérer des données de la base de données dans une certaine portée.
IDBLocaleAwareKeyRange Non standard
Définit une portée de valeurs qui peut être utilisée pour récupérer des données de la base de données dans une certaine portée, triées en fonction des règles de la localisation spécifiée pour un certain index (voir createIndex()'s optionalParameters).
Cette spécification provoque des évènements avec les interfaces personnalisées suivantes:
IDBVersionChangeEvent
L'interface IDBVersionChangeEvent indique que la version de la base de données à changé, résultat de la fonction de saisie d'un évènement IDBOpenDBRequest.onupgradeneeded.
Une précedente version des spécifications a défini ces interfaces, désormais supprimées. Elles sont toujours documentées dans le cas où vous avez besoin de mettre à jour du code déja écrit :
IDBVersionChangeRequest Obsolète
Représente une requête de changement de version de la base de données. Le moyen pour changer de version de la base de données a désormais changé (avec un appel de IDBFactory.open sans aussi appeler IDBDatabase.setVersion), et l'interface IDBOpenDBRequest a désormais la fonction de l'ancienne (supprimée) IDBVersionChangeRequest.
IDBDatabaseException Obsolète
Représente une exception (erreur) qui peut survenir durant les opérations sur la base de données.
IDBTransactionSync Obsolète
Version synchrone de IDBTransaction.
IDBObjectStoreSync Obsolète
Version synchrone de IDBObjectStore.
IDBIndexSync Obsolète
Version synchrone de IDBIndex.
IDBFactorySync Obsolète
Version synchrone de IDBFactory.
IDBEnvironmentSync Obsolète
Version synchrone de IDBEnvironment.
IDBDatabaseSync Obsolète
Version synchrone de IDBDatabase.
IDBCursorSync Obsolète
Version synchrone de IDBCursor.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4