Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

IDBRequest

L'interface IDBRequest de l'API IndexedDB donne accès par ses gestionnaires d'événements aux résultats des requêtes asynchrones sur la base de données, les magasins d'objets ou les index. Chaque opération d'écriture ou lecture sur la base de données utilise une requête.

Cet objet IDBRequest ne contient aucune information sur le résultat de l'opération, mais dès qu'une information est disponible un événement est déclenché. L'objet IDBRequest utilise ses gestionnaires d'événements pour le capter et metre l'information à disposition.

L'accé aux propriétés result ou error peut levé une exception InvalidStateError si on tente d'y accéder alors que la requête est en cours. On peut verifié l'état de la requête avec la propriété readyState

Si on tente d'accéder à la propriété result alors que la requête a échoué ( la propriété error est différénte de NoError) on lèvera aussi cette exception.

Note : This feature is available in Web Workers.

Note: IDBRequest hérite de EventTarget, IDBOpenDBRequest en hérite.

Méthodes

Pas de méthodes.

Propriétés

result Lecture seule
La propriété result de l'interface IDBRequest renvoie le résultat de la requête. Si la requête est en cours ,échoue ou que le résultat n'est pas disponible, l'exception InvalidStateError est levée .
error Lecture seule
La propriété error de l'interface IDBRequest indique le code de l'erreur survenue durant le traitement de la requête. Si la requête est en cours l'exception InvalidStateError est levée.
source Lecture seule
La propriété source de l'interface IDBRequest renvoie la source de la requête, tel qu'un index, un magasin d'ojets ou null s'il n'y à pas de source (lors de l'appel indexedDB.open par exemple).
transaction Lecture seule
La propriété transaction de l'interface IDBRequest renvoie la transaction dans laquelle on fait la requête.La propriètè peut renvoiyer null si requête se fait sans transaction, comme un objet IDBRequest renvoyé par IDBFactory.open dans ce cas on est juste connecté à la base de données.
readyState Lecture seule
La propriété readyState de l'interface IDBRequest renvoie l'état de la requête. Chaque requête débute avec un statut pending et passe au satut done quand la requête réussie ou échoue.

Gestionnaire d'événement

onerror
Le gestionnaire d'événement onerror de l'interface IDBRequest capte l'événement error, déclenché quand une requête renvoie une erreur.
onsuccess
Le gestionnaire d'événement onsuccess de l'interface IDBRequest capte l'événement success, déclenché quand la requête réussie.

Constantes

Constantes readyState

Obsolète depuis Gecko 13 (Firefox 13 / Thunderbird 13 / SeaMonkey 2.10)
Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

depuis Gecko 25+ ces constantes ne sont plus disponibles. Vous devez utiliser directement leurs valeurs. (bug 888598)

Constante Valeur Déscription
DONE "done" La requête est finie.
LOADING "pending" La requête est en cours.

Exemple

Dans l'exemple suivant, on ouvre une base de données et on fait une requête. Les gestionnaires d'événement onsuccess et onerror sont inclus. Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

var db;
// Ouvre une base de données
var DBOpenRequest = window.indexedDB.open("toDoList", 4);

// Ces deux gestionnaires d'événement interviennent quand la dase de données s'ouvre ou non.
DBOpenRequest.onerror = function(event) {
  note.innerHTML += '
  • Erreur de chargement de la base de données loading.
  • '; }; DBOpenRequest.onsuccess = function(event) { note.innerHTML += '
  • La base est ouverte.
  • '; // Affecte le resutat de l'ouverture à la variable. db = DBOpenRequest.result; };

    Spécifications

    Spécification Statut Commentaire
    Indexed Database API
    La définition de 'IDBRequest' dans cette spécification.
    Recommendation

    Compatibilité avec les navigateurs

    Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
    Support basique 23webkit
    24
    10 moz
    16.0 (16.0)
    10, en partie 15 7.1
    Disponible dans workers (Oui) 37.0 (37.0) ? (Oui) ?
    Fonctionnalité Android Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile
    Support basique 4.4 22.0 (22.0) 1.0.1 10 22 8
    Disponible dans workers (Oui) 37.0 (37.0) (Oui) ? (Oui) ?

    Voir aussi

    Étiquettes et contributeurs liés au document

     Contributeurs à cette page : gadgino, inexorabletash
     Dernière mise à jour par : gadgino,