MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

La propriété name, rattachée à l'interface IDBIndex, contient une chaîne de caractères qui permet de désigner l'index courant.

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

Syntaxe

var indexName = IDBIndex.name;
IDBIndex.name = indexName;

Valeur

Une chaîne de caractères qui fournit le nom à l'index.

Exceptions

Différentes exceptions peuvent être déclenchées lorsqu'on souhaite modifier le nom d'un index.

InvalidStateError
L'index ou le magasin d'objets a été supprimé ou la transaction courante n'est pas une transaction de montée de niveau. Le renommage des index est uniquement possible lors des transactions de montée de niveau (c'est-à-dire quand le mode de la transaction est "versionchange").
TransactionInactiveError
La transaction courante n'est pas active.
ConstraintError
Il existe déjà un index avec ce nom.

Exemples

Dans l'exemple qui suit, on ouvre une transaction sur un magasin d'objets pour lequel on récupère l'index lName. Ensuite, on ouvre un curseur sur cet index avec la méthode IDBIndex.openCursor() (celle-ci fonctionne comme la méthode openCursor() qui s'utilise sur les magasins d'objets mais ici, les enregistrements sont triés selon l'index et pas selon la clé primaire).

Le nom de l'index est affiché dans la console grâce à la propriété (ici, le nom sera "lName").

Enfin, on parcourt chacun des enregistrements et on ajoute les données dans un tableau HTML.

function displayDataByIndex() {
  tableEntry.innerHTML = '';
  var transaction = db.transaction(['contactsList'], 'readonly');
  var objectStore = transaction.objectStore('contactsList');

  var myIndex = objectStore.index('lName'); 
  console.log(myIndex.name);

  myIndex.openCursor().onsuccess = function(event) {
    var cursor = event.target.result;
    if(cursor) {
      var tableRow = document.createElement('tr');
      tableRow.innerHTML =   '<td>' + cursor.value.id + '</td>'
                           + '<td>' + cursor.value.lName + '</td>'
                           + '<td>' + cursor.value.fName + '</td>'
                           + '<td>' + cursor.value.jTitle + '</td>'
                           + '<td>' + cursor.value.company + '</td>'
                           + '<td>' + cursor.value.eMail + '</td>'
                           + '<td>' + cursor.value.phone + '</td>'
                           + '<td>' + cursor.value.age + '</td>';
      tableEntry.appendChild(tableRow);  

      cursor.continue();
    } else {
      console.log('Les éléments sont affichés.');    
    }
  };
};

Note : pour un exemple fonctionnel complet, voir notre application To-do (exemple).

Spécifications

Spécification État Commentaires
Indexed Database API
La définition de 'name' dans cette spécification.
Recommendation  

Compatibilité des navigateurs

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support simple 23webkit
24
(Oui) 10 moz
16.0 (16.0)
10 15 7.1
Disponible dans les web workers (Oui) (Oui) 37.0 (37.0) ? (Oui) ?
Possibilité de renommer avec le mutateur lié à name (Oui) ? 49 (49) ? ? ?
Fonctionnalité Android Webview Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome pour Android
Support simple 4.4 (Oui) (Oui) 22.0 (22.0) 10 22 8 (Oui)
Disponible dans les web workers (Oui) (Oui) (Oui) 37.0 (37.0) ? (Oui) ? (Oui)
Possibilité de renommer avec le mutateur lié à name ? (Oui) ? 49.0 (49) ? ? ? (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

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