IDBObjectStore.getKey()

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

La méthode getKey() de l'interface IDBObjectStore retourne un objet IDBRequest, et, dans un thread séparé, retourne la clé sélectionnée par la requête spécifiée. Cela permet de retrouver un enregistrement spécifique depuis un espace de stockage déterminé.

Si la clé a bien été retrouvée, alors un clone structuré (une copie conforme) sera créée et servira comme résultat à l'objet de requête.

Note : Cette fonctionnalité est disponible via les Web Workers.

Syntax

var request = objectStore.getKey(key);

Parameters

key
La clé ou l'intervale de clé qui identifie l'enregistrement à retrouver.

Return Value

An IDBRequest object on which subsequent events related to this operation are fired.

Exceptions

This method may raise a DOMException of one of the following types:

Exception Description
TransactionInactiveError This IDBObjectStore's transaction is inactive.
DataError

The key or key range provided contains an invalid key.

InvalidStateError The IDBObjectStore has been deleted or removed.
 

Example

let openRequest = indexedDB.open("telemetry");
openRequest.onsuccess = (event) => {
  let db = event.target.result;
  let store = db.transaction("netlogs").objectStore("netlogs");

  let today = new Date();
  let yesterday = new Date(today);
  yesterday.setDate(today.getDate() - 1);
  let request = store.getKey(IDBKeyRange(yesterday, today));
  request.onsuccess = (event) => {
    let when = event.target.result;
    alert("The 1st activity in last 24 hours was occurred at " + when);
  };
};

Specifications

Specification Status Comment
Indexed Database API 2.0
La définition de 'getKey()' dans cette spécification.
Recommendation Initial definition

Browser compatibility

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 58 51.0 (51.0) ? 45 ?
Available in workers 58 ? ? 45 ?
 
Feature Android Webview Chrome for Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 58 58 51.0 (51.0) ? 45 ?
Available in workers 58 58 (Oui) ? 45 ?

See also

Étiquettes et contributeurs liés au document

Contributeurs à cette page : Nothus, julienw
Dernière mise à jour par : Nothus,