From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/idbrequest/error/index.md | 147 +++++++++-------------- files/fr/web/api/idbrequest/index.md | 141 +++++++++------------- files/fr/web/api/idbrequest/onerror/index.md | 104 +++++++--------- files/fr/web/api/idbrequest/onsuccess/index.md | 106 +++++++--------- files/fr/web/api/idbrequest/readystate/index.md | 85 ++++++------- files/fr/web/api/idbrequest/result/index.md | 53 ++++---- files/fr/web/api/idbrequest/source/index.md | 87 ++++++-------- files/fr/web/api/idbrequest/transaction/index.md | 93 +++++++------- 8 files changed, 340 insertions(+), 476 deletions(-) (limited to 'files/fr/web/api/idbrequest') diff --git a/files/fr/web/api/idbrequest/error/index.md b/files/fr/web/api/idbrequest/error/index.md index 1604f594ad..95598e8927 100644 --- a/files/fr/web/api/idbrequest/error/index.md +++ b/files/fr/web/api/idbrequest/error/index.md @@ -10,64 +10,39 @@ tags: - Reference translation_of: Web/API/IDBRequest/error --- -
{{APIRef("IndexedDB")}}
- -

La propriété error de l'interface {{domxref("IDBRequest")}} renvoie l'erreur associée lorsque la requête est un échec.

- -

{{AvailableInWorkers}}

- -

Syntaxe

- -
var myError = request.error;
- -

Valeur

- -

Une erreur {{domxref("DOMError")}} qui contient l'erreur pertinente. Pour Chrome 48 et les versions ultérieures, cette propriété est une {{domxref("DOMException")}} car DOMError a été retiré du standard pour le DOM. Les codes d'erreurs suivants sont utilisés selon les conditions d'erreur :

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ErreurExplication
AbortErrorSi on annule la transaction en cours, toutes les requêtes en cours reçoivent cette erreur.
ConstraintErrorErreur obtenue lorsqu'on tente d'insérer des données qui ne respectent pas une contrainte. C'est un type d'exception utilisé lorsqu'on crée des magasins d'objet et des index. On aura cette erreur lorsqu'on essaiera par exemple d'ajouter une clé qui existe déjà dans l'enregistrement.
QuotaExceededErrorErreur obtenue lorsque atteint le quota d'espace disque et que l'utilisateur refuse de céder plus d'espace mémoire.
UnknownErrorErreur obtenue lorsque l'opération a échoué pour des raisons qui ne sont pas propres à la base de données (par exemple une erreur d'écriture sur le disque).
NoErrorValeur utilisée lorsque la requête est réussie.
VersionErrorErreur obtenue lorsqu'on essaye d'ouvrir une base de données avec une version inférieure à celle dont elle dispose déjà.
- -

En plus des codes d'erreur envoyés à l'objet {{domxref("IDBRequest")}}, les opérations asynchrones peuvent également déclencher des exceptions. La liste décrit les problèmes qui peuvent se produire lorsque la requête est en cours d'exécution mais d'autres problèmes peuvent apparaître lors de la construction de la requête. Ainsi, si la requête a échoué et que le résultat n'est pas disponible, l'exception InvalidStateError sera levée.

- -

Exemples

- -

Dans l'exemple qui suit, on effectue une requête sur le titre de l'enregistrement. Le gestionnaire d'évèvenement onsuccess traite l'enregistrement obtenu depuis le magasin d'objet ({{domxref("IDBObjectStore")}}) et qui est disponible via objectStoreTitleRequest.result. Le gestionnaire met ensuite à jour une propriété de l'enregistrement puis replace l'enregistrement mis à jour dans le magasin d'objet.

- -

On dispose également d'une fonction onerror qui permet d'indiquer l'erreur qui s'est produite si la requêté échoue. Pour consulter un exemple complet, voir l'application de notifications To-do (cf. la démonstration live).

- -
var title = "Walk dog";
+{{APIRef("IndexedDB")}}
+
+La propriété **`error`** de l'interface {{domxref("IDBRequest")}} renvoie l'erreur associée lorsque la requête est un échec.
+
+{{AvailableInWorkers}}
+
+## Syntaxe
+
+    var myError = request.error;
+
+### Valeur
+
+Une erreur {{domxref("DOMError")}} qui contient l'erreur pertinente. Pour Chrome 48 et les versions ultérieures, cette propriété est une {{domxref("DOMException")}} car `DOMError` a été retiré du standard pour le DOM. Les codes d'erreurs suivants sont utilisés selon les conditions d'erreur :
+
+| Erreur               | Explication                                                                                                                                                                                                                                                                                 |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `AbortError`         | Si on annule la transaction en cours, toutes les requêtes en cours reçoivent cette erreur.                                                                                                                                                                                                  |
+| `ConstraintError`    | Erreur obtenue lorsqu'on tente d'insérer des données qui ne respectent pas une contrainte. C'est un type d'exception utilisé lorsqu'on crée des magasins d'objet et des index. On aura cette erreur lorsqu'on essaiera par exemple d'ajouter une clé qui existe déjà dans l'enregistrement. |
+| `QuotaExceededError` | Erreur obtenue lorsque atteint le quota d'espace disque et que l'utilisateur refuse de céder plus d'espace mémoire.                                                                                                                                                                         |
+| `UnknownError`       | Erreur obtenue lorsque l'opération a échoué pour des raisons qui ne sont pas propres à la base de données (par exemple une erreur d'écriture sur le disque).                                                                                                                                |
+| `NoError`            | Valeur utilisée lorsque la requête est réussie.                                                                                                                                                                                                                                             |
+| `VersionError`       | Erreur obtenue lorsqu'on essaye d'ouvrir une base de données avec une version inférieure à celle dont elle dispose déjà.                                                                                                                                                                    |
+
+En plus des codes d'erreur envoyés à l'objet {{domxref("IDBRequest")}}, les opérations asynchrones peuvent également déclencher des exceptions. La liste décrit les problèmes qui peuvent se produire lorsque la requête est en cours d'exécution mais d'autres problèmes peuvent apparaître lors de la construction de la requête. Ainsi, si la requête a échoué et que le résultat n'est pas disponible, l'exception `InvalidStateError `sera levée.
+
+## Exemples
+
+Dans l'exemple qui suit, on effectue une requête sur le titre de l'enregistrement. Le gestionnaire d'évèvenement `onsuccess` traite l'enregistrement obtenu depuis le magasin d'objet ({{domxref("IDBObjectStore")}}) et qui est disponible via `objectStoreTitleRequest.result`. Le gestionnaire met ensuite à jour une propriété de l'enregistrement puis replace l'enregistrement mis à jour dans le magasin d'objet.
+
+On dispose également d'une fonction `onerror` qui permet d'indiquer l'erreur qui s'est produite si la requêté échoue. Pour consulter un exemple complet, voir [l'application de notifications To-do](https://github.com/mdn/to-do-notifications/) (cf. [la démonstration _live_](https://mdn.github.io/to-do-notifications/)).
+
+```js
+var title = "Walk dog";
 
 // On ouvre une transaction
 var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList');
@@ -98,37 +73,25 @@ objectStoreTitleRequest.onerror = function() {
   // S'il se produit une erreur pendant la requête
   // on l'enregistre
   console.log("Il y a eu une erreur pour la récupération des données : " + objectStoreTitleRequest.error);
-};
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('IndexedDB', '#widl-IDBRequest-error', 'error')}}{{Spec2('IndexedDB')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("api.IDBRequest.error")}}

- -

Voir aussi

- - +}; +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------- | ---------------------------- | ------------ | +| {{SpecName('IndexedDB', '#widl-IDBRequest-error', 'error')}} | {{Spec2('IndexedDB')}} |   | + +## Compatibilité des navigateurs + +{{Compat("api.IDBRequest.error")}} + +## Voir aussi + +- [Utiliser IndexedDB](/fr/docs/Web/API/API_IndexedDB/Using_IndexedDB) +- Initier une connexion : {{domxref("IDBDatabase")}} +- Utiliser les transactions : {{domxref("IDBTransaction")}} +- Définir un intervalle de clés : {{domxref("IDBKeyRange")}} +- Récupérer et modifier les données : {{domxref("IDBObjectStore")}} +- Utiliser les curseurs {{domxref("IDBCursor")}} +- Exemple de référence : [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) ([exemple _live_](https://mdn.github.io/to-do-notifications/)). diff --git a/files/fr/web/api/idbrequest/index.md b/files/fr/web/api/idbrequest/index.md index dac0d4018c..ef33447c2f 100644 --- a/files/fr/web/api/idbrequest/index.md +++ b/files/fr/web/api/idbrequest/index.md @@ -12,59 +12,56 @@ tags: - TopicStub translation_of: Web/API/IDBRequest --- -

{{APIRef("IndexedDB")}}

+{{APIRef("IndexedDB")}} -

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.

+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 mettre l'information à disposition.

+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 mettre l'information à disposition. -

Toute les opération asynchrone retourne immédiatement une instance IDBRequest avec une propriété readyState défini à 'pending' qui passe à  'done' lorsque la requête réussie ou échoue. Quand l'état passe à done, chaque requête retourne result et error, et un évènement est envoyé sur la requête. Quand l'état est sur pending, chaque accès à result ou error lève une exception InvalidStateError.

+Toute les opération asynchrone retourne immédiatement une instance **`IDBRequest`** avec une propriété `readyState` défini à `'pending'` qui passe à  `'done'` lorsque la requête réussie ou échoue. Quand l'état passe à `done`, chaque requête retourne `result` et `error`, et un évènement est envoyé sur la requête. Quand l'état est sur `pending`, chaque accès à `result` ou `error` lève une exception `InvalidStateError`. -

Pour faire simple, chaque méthode asynchrome retourne un objet de requête. Si l'opération réussi, le résultat est disponible dans la propriété result et un évènement success est lancé ({{domxref("IDBRequest.onsuccess")}}). Si une erreur est rencontrée, une exeption est disponible dans la propriété error et un évènement error est lancé ({{domxref("IDBRequest.onerror")}}).

+Pour faire simple, chaque méthode asynchrome retourne un objet de requête. Si l'opération réussi, le résultat est disponible dans la propriété `result` et un évènement `success` est lancé ({{domxref("IDBRequest.onsuccess")}}). Si une erreur est rencontrée, une exeption est disponible dans la propriété `error` et un évènement `error` est lancé ({{domxref("IDBRequest.onerror")}}). -

L'interface {{domxref("IDBOpenDBRequest")}} est dérivé de IDBRequest.

+L'interface {{domxref("IDBOpenDBRequest")}} est dérivé de `IDBRequest`. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

{{InheritanceDiagram}}

+{{InheritanceDiagram}} -

Propriétés

+## Propriétés -

Hérite des propriétés de {{domxref("EventTarget")}}.

+_Hérite des propriétés de {{domxref("EventTarget")}}._ -
-
{{domxref("IDBRequest.result","result")}} {{readonlyInline}}
-
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.
-
{{domxref("IDBRequest.error","error")}} {{readonlyInline}}
-
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.
-
{{domxref("IDBRequest.source","source")}} {{readonlyInline}}
-
La propriété source de l'interface IDBRequest renvoie la source de la requête, tel qu'un {{domxref("IDBIndex","index")}}, un {{domxref("IDBObjectStore","magasin d'ojets")}} ou null s'il n'y a pas de source (lors de l'appel {{domxref("indexedDB.open")}} par exemple).
-
{{domxref("IDBRequest.transaction","transaction")}} {{readonlyInline}}
-
La propriété transaction de l'interface IDBRequest renvoie la {{domxref("IDBTransaction","transaction")}} dans laquelle on fait la requête. La propriété peut renvoyer null si requête se fait sans transaction, comme un objet IDBRequest renvoyé par {{domxref("IDBFactory.open")}} dans ce cas on est juste connecté à la base de données.
-
{{domxref("IDBRequest.readyState","readyState")}} {{readonlyInline}}
-
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 statut done quand la requête réussie ou échoue.
-
+- {{domxref("IDBRequest.result","result")}} {{readonlyInline}} + - : 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. +- {{domxref("IDBRequest.error","error")}} {{readonlyInline}} + - : 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. +- {{domxref("IDBRequest.source","source")}} {{readonlyInline}} + - : La propriété **`source`** de l'interface **`IDBRequest`** renvoie la source de la requête, tel qu'un {{domxref("IDBIndex","index")}}, un {{domxref("IDBObjectStore","magasin d'ojets")}} ou `null` s'il n'y a pas de source (lors de l'appel {{domxref("indexedDB.open")}} par exemple). +- {{domxref("IDBRequest.transaction","transaction")}} {{readonlyInline}} + - : La propriété **`transaction`** de l'interface **`IDBRequest`** renvoie la {{domxref("IDBTransaction","transaction")}} dans laquelle on fait la requête. La propriété peut renvoyer `null` si requête se fait sans transaction, comme un objet IDBRequest renvoyé par {{domxref("IDBFactory.open")}} dans ce cas on est juste connecté à la base de données. +- {{domxref("IDBRequest.readyState","readyState")}} {{readonlyInline}} + - : 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 statut `done` quand la requête réussie ou échoue. -

Méthodes

+## Méthodes -

Pas de méthodes spécifiques, mais hérite des méthodes de {{domxref("EventTarget")}}.

+_Pas de méthodes spécifiques, mais hérite des méthodes de {{domxref("EventTarget")}}._ -

Gestionnaire d'événement

+## Gestionnaire d'événement -

On peut écouter les évènement avec addEventListener() ou bien en assignant un gestionnaire d'évènement à la propriété oneventname de cette interface.

+On peut écouter les évènement avec `addEventListener()` ou bien en assignant un gestionnaire d'évènement à la propriété `oneventname` de cette interface. -
-
{{domxref("IDBRequest.onerror","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.
-
{{domxref("IDBRequest.onsuccess","onsuccess")}}
-
Le gestionnaire d'événement onsuccess de l'interface IDBRequest capte l'événement success, déclenché quand la requête réussie.
-
+- {{domxref("IDBRequest.onerror","onerror")}} + - : Le gestionnaire d'événement **`onerror`** de l'interface **`IDBRequest`** capte l'événement [`error`](/en-US/docs/Web/Events/error), déclenché quand une requête renvoie une erreur. +- {{domxref("IDBRequest.onsuccess","onsuccess")}} + - : Le gestionnaire d'événement **`onsuccess`** de l'interface **`IDBRequest`** capte l'événement [`success`](/en-US/docs/Web/Events/success), déclenché quand la requête réussie. -

Exemple

+## Exemple -

Dans l'exemple suivant, on ouvre une base de données et on fait une requête. Les gestionnaires d'événement {{domxref("IDBRequest.onsuccess","onsuccess")}} et {{domxref("IDBRequest","onerror")}} sont inclus. Pour un exemple de travail complet, voir notre application To-do Notifications (voir l'exemple en direct).

+Dans l'exemple suivant, on ouvre une base de données et on fait une requête. Les gestionnaires d'événement `{{domxref("IDBRequest.onsuccess","onsuccess")}}` et `{{domxref("IDBRequest","onerror")}}` sont inclus. Pour un exemple de travail complet, voir notre application [To-do Notifications](https://github.com/mdn/to-do-notifications/) ([voir l'exemple en direct](http://mdn.github.io/to-do-notifications/)). -
var db;
+```js
+var db;
 
 // Ouvre une base de données.
 var DBOpenRequest = window.indexedDB.open("toDoList", 4);
@@ -72,58 +69,34 @@ var DBOpenRequest = window.indexedDB.open("toDoList", 4);
 // Ces deux gestionnaires d'événement interviennent quand la dase de
 // de données s'ouvre ou non.
 DBOpenRequest.onerror = function(event) {
-  note.innerHTML += '<li>Error loading database.</li>';
+  note.innerHTML += '
  • Error loading database.
    • ';
 };
 
 DBOpenRequest.onsuccess = function(event) {
-  note.innerHTML += '<li>Database initialised.</li>';
+  note.innerHTML += '
  • Database initialised.
    • ';
 
   // Affecte le resutat de l'ouverture à la variable.
   db = DBOpenRequest.result;
-};
    - -

    Spécifications

    - - - - - - - - - - - - - - - - - - - -
    SpécificationStatutCommentaire
    {{SpecName('IndexedDB', '#idbrequest', 'IDBRequest')}}{{Spec2('IndexedDB')}}Définition initiale.
    {{SpecName("IndexedDB 2", "#request-api", "IDBRequest")}}{{Spec2("IndexedDB 2")}}
    - -

    Compatibilité avec les navigateurs

    - -
    -
    -
    - - -

    {{Compat("api.IDBRequest")}}

    -
    -
    -
    - -

    Voir aussi

    - - +}; +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------- | -------------------------------- | -------------------- | +| {{SpecName('IndexedDB', '#idbrequest', 'IDBRequest')}} | {{Spec2('IndexedDB')}} | Définition initiale. | +| {{SpecName("IndexedDB 2", "#request-api", "IDBRequest")}} | {{Spec2("IndexedDB 2")}} | | + +## Compatibilité avec les navigateurs + +{{Compat("api.IDBRequest")}} + +## Voir aussi + +- [Utiliser IndexedDB](/fr/docs/Web/API/IndexedDB_API/Using_IndexedDB) +- Démarrer une transaction: {{domxref("IDBDatabase")}} +- Utiliser les transactions: {{domxref("IDBTransaction")}} +- Définir un intervalle de clés: {{domxref("IDBKeyRange")}} +- Récupérer et modifier vos données: {{domxref("IDBObjectStore")}} +- utiliser les curseurs: {{domxref("IDBCursor")}} +- Exemple de référence: [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) ([view example live](http://mdn.github.io/to-do-notifications/).) diff --git a/files/fr/web/api/idbrequest/onerror/index.md b/files/fr/web/api/idbrequest/onerror/index.md index dc57020d05..edad1a851e 100644 --- a/files/fr/web/api/idbrequest/onerror/index.md +++ b/files/fr/web/api/idbrequest/onerror/index.md @@ -3,82 +3,70 @@ title: IDBRequest.onerror slug: Web/API/IDBRequest/onerror translation_of: Web/API/IDBRequest/onerror --- -

    {{ APIRef("IndexedDB") }}

    +{{ APIRef("IndexedDB") }} -

    le gestionnaire d'événement onerror de l'interface {{domxref("IDBRequest")}} capte l'événement error, déclenché quand une requête renvoie une erreur.

    +le gestionnaire d'événement **`onerror`** de l'interface {{domxref("IDBRequest")}} capte l'événement [`error`](/en-US/docs/Web/Events/error), déclenché quand une requête renvoie une erreur. -

    Le gestionnaire d'événement reçoit l'événement error avec le type="error" en paramètre.

    +Le gestionnaire d'événement reçoit l'événement [error](/en-US/docs/Web/Events/error) avec le type="error" en paramètre. -

    {{AvailableInWorkers}}

    +{{AvailableInWorkers}} -

    Syntaxe

    +## Syntaxe -
    request.onerror = function( event ) { ... };
    +```js +request.onerror = function( event ) { ... }; +``` -

    Exemple

    +## Exemple -

    L'exemple suivant demande un titre d'enregistrement donné, onsuccess obtient l'enregistrement associé au {{domxref("IDBObjectStore","magasin d'objets")}} (mis à disposition en tant que objectStoreTitleRequest.result), on met à jour une propriété de l'enregistrement, puis le sauve dans le magasin d'objets. En bas le gestionnaire d'événement onerror affiche le code d'erreur si la {{domxref("IDBRequest","requête")}} échoue. Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

    +L'exemple suivant demande un titre d'enregistrement donné, `onsuccess` obtient l'enregistrement associé au {{domxref("IDBObjectStore","magasin d'objets")}} (mis à disposition en tant que `objectStoreTitleRequest.result`), on met à jour une propriété de l'enregistrement, puis le sauve dans le magasin d'objets. En bas le gestionnaire d'événement `onerror` affiche le code d'erreur si la {{domxref("IDBRequest","requête")}} échoue. Pour un exemple de travail complet, voir notre [To-do Notifications](https://github.com/mdn/to-do-notifications/) app ([view example live](http://mdn.github.io/to-do-notifications/)). -
    var title = "Walk dog";
+    var title = "Walk dog";
 
-// Ouvrez une transaction comme d'habitude
-var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList');
+    // Ouvrez une transaction comme d'habitude
+    var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList');
 
-// Obtenez l'objet toDoList qui a ce titre
-var objectStoreTitleRequest = objectStore.get(title);
+    // Obtenez l'objet toDoList qui a ce titre
+    var objectStoreTitleRequest = objectStore.get(title);
 
-objectStoreTitleRequest.onsuccess = function() {
-  // Prenez l'objet de données renvoyé comme résultat
-  var data = objectStoreTitleRequest.result;
+    objectStoreTitleRequest.onsuccess = function() {
+      // Prenez l'objet de données renvoyé comme résultat
+      var data = objectStoreTitleRequest.result;
 
-  // Mettre à jour la valeur notified de l'objet à "yes"
-  data.notified = "yes";
+      // Mettre à jour la valeur notified de l'objet à "yes"
+      data.notified = "yes";
 
-  // Créer une autre requête qui insère le nouvelle élément dans la base de données
-  var updateTitleRequest = objectStore.put(data);
+      // Créer une autre requête qui insère le nouvelle élément dans la base de données
+      var updateTitleRequest = objectStore.put(data);
 
-  // Lorsque cette requête réussit, appelle de la fonction displayData() pour mettre à jour l'affichage
-  updateTitleRequest.onsuccess = function() {
-    displayData();
-  };
-};
+      // Lorsque cette requête réussit, appelle de la fonction displayData() pour mettre à jour l'affichage
+      updateTitleRequest.onsuccess = function() {
+        displayData();
+      };
+    };
 
-objectStoreTitleRequest.onerror = function() {
-  // Si une erreur se produit à la demande, on l'affiche
-  console.log("Il y a eu une erreur dans la récupération des données: " + objectStoreTitleRequest.error);
-};
-
    + objectStoreTitleRequest.onerror = function() { + // Si une erreur se produit à la demande, on l'affiche + console.log("Il y a eu une erreur dans la récupération des données: " + objectStoreTitleRequest.error); + }; -

    Spécifications

    +## Spécifications - - - - - - - - - - - - - -
    SpécificationStatutCommentaire
    {{SpecName('IndexedDB', '#widl-IDBRequest-onerror', 'onerror')}}{{Spec2('IndexedDB')}} 
    +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | ---------------------------- | ----------- | +| {{SpecName('IndexedDB', '#widl-IDBRequest-onerror', 'onerror')}} | {{Spec2('IndexedDB')}} |   | -

    Compatibilité des navigateurs

    +## Compatibilité des navigateurs -

    {{Compat("api.IDBRequest.onerror")}}

    +{{Compat("api.IDBRequest.onerror")}} -

    Voir aussi

    +## Voir aussi - +- [Using IndexedDB](/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB) +- [Error Event](/en-US/docs/Web/Events/error) +- Starting transactions: {{domxref("IDBDatabase")}} +- Using transactions: {{domxref("IDBTransaction")}} +- Setting a range of keys: {{domxref("IDBKeyRange")}} +- Retrieving and making changes to your data: {{domxref("IDBObjectStore")}} +- Using cursors: {{domxref("IDBCursor")}} +- Reference example: [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) ([view example live](http://mdn.github.io/to-do-notifications/).) diff --git a/files/fr/web/api/idbrequest/onsuccess/index.md b/files/fr/web/api/idbrequest/onsuccess/index.md index a13ed4c5e7..201d7b58cf 100644 --- a/files/fr/web/api/idbrequest/onsuccess/index.md +++ b/files/fr/web/api/idbrequest/onsuccess/index.md @@ -3,84 +3,70 @@ title: IDBRequest.onsuccess slug: Web/API/IDBRequest/onsuccess translation_of: Web/API/IDBRequest/onsuccess --- -

    {{ APIRef("IndexedDB") }}

    +{{ APIRef("IndexedDB") }} +Le gestionnaire d'événement **`onsuccess`** de l'interface {{domxref("IDBRequest")}} capte l'événement [`success`](/en-US/docs/Web/Events/success), déclenché quand la requête réussie. -

    Le gestionnaire d'événement onsuccess de l'interface {{domxref("IDBRequest")}} capte l'événement success, déclenché quand la requête réussie.

    +Le gestionnaire d'événement un événement [success](/en-US/docs/Web/Events/success) avec le type="success" en paramètre. -

    Le gestionnaire d'événement un événement success avec le type="success" en paramètre.

    +{{AvailableInWorkers}} -

    {{AvailableInWorkers}}

    +## Syntaxe +```js +request.onsuccess = function( event ) { ... }; +``` -

    Syntaxe

    +## Exemple -
    request.onsuccess = function( event ) { ... };
    +L'exemple suivant demande un titre d'enregistrement donné, `onsuccess` obtient l'enregistrement associé de {{domxref("IDBObjectStore")}} (mis à disposition en tant que `objectStoreTitleRequest.result`), on met à jour une propriété de l'enregistrement, puis le sauve dans le magasin d'objets. En bas le gestionnaire d'événement `onerror` affiche le code d'erreur si la requête échoue. Pour un exemple de travail complet, voir notre [To-do Notifications](https://github.com/mdn/to-do-notifications/) app ([view example live](http://mdn.github.io/to-do-notifications/)). -

    Exemple

    + var title = "Walk dog"; -

    L'exemple suivant demande un titre d'enregistrement donné, onsuccess obtient l'enregistrement associé de {{domxref("IDBObjectStore")}} (mis à disposition en tant que objectStoreTitleRequest.result), on met à jour une propriété de l'enregistrement, puis le sauve dans le magasin d'objets. En bas le gestionnaire d'événement onerror affiche le code d'erreur si la requête échoue. Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

    + // Ouvrez une transaction comme d'habitude + var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList'); -
    var title = "Walk dog";
+    // Obtenez l'objet toDoList qui a ce titre
+    var objectStoreTitleRequest = objectStore.get(title);
 
-// Ouvrez une transaction comme d'habitude
-var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList');
+    objectStoreTitleRequest.onsuccess = function() {
+      // Prenez l'objet de données renvoyé comme résultat
+      var data = objectStoreTitleRequest.result;
 
-// Obtenez l'objet toDoList qui a ce titre
-var objectStoreTitleRequest = objectStore.get(title);
+      // Mettre à jour la valeur notified de l'objet à "yes"
+      data.notified = "yes";
 
-objectStoreTitleRequest.onsuccess = function() {
-  // Prenez l'objet de données renvoyé comme résultat
-  var data = objectStoreTitleRequest.result;
+      // Créer une autre requête qui insère le nouvelle élément dans la base de données
+      var updateTitleRequest = objectStore.put(data);
 
-  // Mettre à jour la valeur notified de l'objet à "yes"
-  data.notified = "yes";
+      // Lorsque cette requête réussit, appelle de la fonction displayData() pour mettre à jour l'affichage
+      updateTitleRequest.onsuccess = function() {
+        displayData();
+      };
+    };
 
-  // Créer une autre requête qui insère le nouvelle élément dans la base de données
-  var updateTitleRequest = objectStore.put(data);
+    objectStoreTitleRequest.onerror = function() {
+      // Si une erreur se produit à la demande, on l'affiche
+      console.log("Il y a eu une erreur dans la récupération des données: " + objectStoreTitleRequest.error);
+    };
 
-  // Lorsque cette requête réussit, appelle de la fonction displayData() pour mettre à jour l'affichage
-  updateTitleRequest.onsuccess = function() {
-    displayData();
-  };
-};
+## Spécifications
 
-objectStoreTitleRequest.onerror = function() {
-  // Si une erreur se produit à la demande, on l'affiche
-  console.log("Il y a eu une erreur dans la récupération des données: " + objectStoreTitleRequest.error);
-};
-
    +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | ---------------------------- | ----------- | +| {{SpecName('IndexedDB', '#widl-IDBRequest-onsuccess', 'onsuccess')}} | {{Spec2('IndexedDB')}} |   | -

    Spécifications

    +## Compatibilité des navigateurs - - - - - - - - - - - - - -
    SpécificationStatutCommentaire
    {{SpecName('IndexedDB', '#widl-IDBRequest-onsuccess', 'onsuccess')}}{{Spec2('IndexedDB')}} 
    +{{Compat("api.IDBRequest.onsuccess")}} -

    Compatibilité des navigateurs

    +## Voir aussi -

    {{Compat("api.IDBRequest.onsuccess")}}

    - -

    Voir aussi

    - - +- [Using IndexedDB](/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB) +- [Success Event](/en-US/docs/Web/Events/success) +- Starting transactions: {{domxref("IDBDatabase")}} +- Using transactions: {{domxref("IDBTransaction")}} +- Setting a range of keys: {{domxref("IDBKeyRange")}} +- Retrieving and making changes to your data: {{domxref("IDBObjectStore")}} +- Using cursors: {{domxref("IDBCursor")}} +- Reference example: [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) ([view example live](http://mdn.github.io/to-do-notifications/).) diff --git a/files/fr/web/api/idbrequest/readystate/index.md b/files/fr/web/api/idbrequest/readystate/index.md index 2a91b7552e..710868b47b 100644 --- a/files/fr/web/api/idbrequest/readystate/index.md +++ b/files/fr/web/api/idbrequest/readystate/index.md @@ -9,27 +9,28 @@ tags: - Reference translation_of: Web/API/IDBRequest/readyState --- -
    {{APIRef("IndexedDB")}}
    +{{APIRef("IndexedDB")}} -

    La propriété readyState, rattachée à l'interface {{domxref("IDBRequest")}}, est une propriété en lecture seule qui indique l'état de la requête.

    +La propriété **`readyState`**, rattachée à l'interface {{domxref("IDBRequest")}}, est une propriété en lecture seule qui indique l'état de la requête. -

    Chaque requête démarre avec l'état pending (c'est-à-dire en attente). Cet état vaut ensuite done (fini) lorsque la requête est terminée (en cas de réussite de l'opération comme en cas d'échec).

    +Chaque requête démarre avec l'état `pending` (c'est-à-dire en attente). Cet état vaut ensuite `done` (fini) lorsque la requête est terminée (en cas de réussite de l'opération comme en cas d'échec). -

    {{AvailableInWorkers}}

    +{{AvailableInWorkers}} -

    Syntaxe

    +## Syntaxe -
    var currentReadyState = request.readyState;
    + var currentReadyState = request.readyState; -

    Valeur

    +### Valeur -

    La valeur {{domxref("IDBRequestReadyState")}} de la requête, qui peut être l'un de deux valeurs. pending lorsque la requête est en attente, done lorsque celle-ci est finie.

    +La valeur {{domxref("IDBRequestReadyState")}} de la requête, qui peut être l'un de deux valeurs. `pending` lorsque la requête est en attente, `done` lorsque celle-ci est finie. -

    Exemples

    +## Exemples -

    Dans l'exemple qui suit, on effectue une requête sur un enregistrement avec un titre donné et on recupère l'enregistrement associé grâce au gestionnaire d'évènement onsuccess à partir du magasin d'objets {{domxref("IDBObjectStore")}}. Ensuite, on met à jour une des propriétés de cet enregistrement et on replace cet objet mis à jour dans le magasin d'objets via une autre requête. La valeur de la propriété readyState pour la deuxième requête est affichée dans la console. Pour consulter un exemple fonctionnel complet, vous pouvez vous référer à notre appliction To-do Notifications (cf. également l'exemple live).

    +Dans l'exemple qui suit, on effectue une requête sur un enregistrement avec un titre donné et on recupère l'enregistrement associé grâce au gestionnaire d'évènement `onsuccess` à partir du magasin d'objets {{domxref("IDBObjectStore")}}. Ensuite, on met à jour une des propriétés de cet enregistrement et on replace cet objet mis à jour dans le magasin d'objets via une autre requête. La valeur de la propriété `readyState` pour la deuxième requête est affichée dans la console. Pour consulter un exemple fonctionnel complet, vous pouvez vous référer à notre appliction [To-do Notifications](https://github.com/mdn/to-do-notifications/) ([cf. également l'exemple _live_](https://mdn.github.io/to-do-notifications/)). -
    var title = "Walk dog";
+```js
+var title = "Walk dog";
 
 // On ouvre une transaction
 var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList');
@@ -58,42 +59,26 @@ objectStoreTitleRequest.onsuccess = function() {
   updateTitleRequest.onsuccess = function() {
     displayData();
   };
-};
    - -

    Spécifications

    - - - - - - - - - - - - - - - - - - - -
    SpécificationÉtatCommentaires
    {{SpecName('IndexedDB', '#widl-IDBRequest-readyState', 'readyState')}}{{Spec2('IndexedDB')}} 
    {{SpecName("IndexedDB 2", "#dom-idbrequest-readystate", "readyState")}}{{Spec2("IndexedDB 2")}} 
    - -

    Compatibilité des navigateurs

    - -

    {{Compat("api.IDBRequest.readyState")}}

    - -

    Voir aussi

    - - +}; +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ------------ | +| {{SpecName('IndexedDB', '#widl-IDBRequest-readyState', 'readyState')}} | {{Spec2('IndexedDB')}} |   | +| {{SpecName("IndexedDB 2", "#dom-idbrequest-readystate", "readyState")}} | {{Spec2("IndexedDB 2")}} |   | + +## Compatibilité des navigateurs + +{{Compat("api.IDBRequest.readyState")}} + +## Voir aussi + +- [Manipuler IndexedDB](/fr/docs/Web/API/API_IndexedDB/Using_IndexedDB) +- Démarrer des transactions : {{domxref("IDBDatabase")}} +- Manipuler des transactions : {{domxref("IDBTransaction")}} +- Définir un intervalle de clés : {{domxref("IDBKeyRange")}} +- Récupérer des données et les modifier : {{domxref("IDBObjectStore")}} +- Manipuler des curseurs : {{domxref("IDBCursor")}} +- Exemple de référence pour IndexedDB : [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) diff --git a/files/fr/web/api/idbrequest/result/index.md b/files/fr/web/api/idbrequest/result/index.md index 066ba37fa7..69b9d13094 100644 --- a/files/fr/web/api/idbrequest/result/index.md +++ b/files/fr/web/api/idbrequest/result/index.md @@ -4,29 +4,27 @@ slug: Web/API/IDBRequest/result translation_of: Web/API/IDBRequest/result browser-compat: api.IDBRequest.result --- -
    {{APIRef("IndexedDB")}}
    +{{APIRef("IndexedDB")}} -

    La propriété result, rattachée à l'interface IDBRequest, renvoie le résultat de la requête. Si la requête échoue et que le résultat n'est pas disponible, une exception InvalidStateError sera levée.

    +La propriété **`result`**, rattachée à l'interface [`IDBRequest`](/fr/docs/Web/API/IDBRequest), renvoie le résultat de la requête. Si la requête échoue et que le résultat n'est pas disponible, une exception `InvalidStateError` sera levée. -
    -

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

    -
    +> **Note :** Cette fonctionnalité est disponible via les [Web Workers](/fr/docs/Web/API/Web_Workers_API). -

    Syntaxe

    +## Syntaxe -
    +```js
 let resultat = request.result;
-
    +``` -

    Valeur

    +### Valeur -

    La valeur du résultat de la requête (le type dépend des objets du magasin d'objets).

    +La valeur du résultat de la requête (le type dépend des objets du magasin d'objets). -

    Exemple

    +## Exemple -

    Dans l'exemple qui suit, on souhaite récupérer l'enregistrement qui correspond à un titre donné. Le gestionnaire d'évènements onsuccess permet de récupérer l'enregistrement contenu dans le magasin d'objet (IDBObjectStore) (via objectStoreTitleRequest.result). Ensuite, on met à jour une propriété de cet enregistrement et on replace cet enregistrement dans le magasin d'objet. Pour un exemple fonctionnel complet, voir l'application To-do Notifications (voir l'exemple live).

    +Dans l'exemple qui suit, on souhaite récupérer l'enregistrement qui correspond à un titre donné. Le gestionnaire d'évènements `onsuccess` permet de récupérer l'enregistrement contenu dans le magasin d'objet ([`IDBObjectStore`](/fr/docs/Web/API/IDBObjectStore)) (via `objectStoreTitleRequest.result`). Ensuite, on met à jour une propriété de cet enregistrement et on replace cet enregistrement dans le magasin d'objet. Pour un exemple fonctionnel complet, voir [l'application To-do Notifications](https://github.com/mdn/to-do-notifications/) ([voir l'exemple _live_](https://mdn.github.io/to-do-notifications/)). -
    +```js
 let title = "Promener le chien";
 
 // On ouvre une transaction en lecture/écriture
@@ -49,24 +47,23 @@ objectStoreTitleRequest.onsuccess = function() {
   updateTitleRequest.onsuccess = function() {
     displayData();
   };
-};
    +}; +``` -

    Spécifications

    +## Spécifications -

    {{Specifications}}

    +{{Specifications}} -

    Compatibilité des navigateurs

    +## Compatibilité des navigateurs -

    {{Compat}}

    +{{Compat}} -

    Voir aussi

    +## Voir aussi - +- [Utiliser IndexedDB](/fr/docs/Web/API/IndexedDB_API/Using_IndexedDB) +- Initier une transaction : [`IDBDatabase`](/fr/docs/Web/API/IDBDatabase) +- Utiliser les transactions : [`IDBTransaction`](/fr/docs/Web/API/IDBTransaction) +- Définir un intervalle de clés : [`IDBKeyRange`](/fr/docs/Web/API/IDBKeyRange) +- Récupérer et modifier les données : [`IDBObjectStore`](/fr/docs/Web/API/IDBObjectStore) +- Utiliser les curseurs : [`IDBCursor`](/fr/docs/Web/API/IDBCursor) +- Exemple de référence : [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) ([exemple _live_](https://mdn.github.io/to-do-notifications/)). diff --git a/files/fr/web/api/idbrequest/source/index.md b/files/fr/web/api/idbrequest/source/index.md index 8a03050021..68ea7bf33d 100644 --- a/files/fr/web/api/idbrequest/source/index.md +++ b/files/fr/web/api/idbrequest/source/index.md @@ -9,28 +9,28 @@ tags: - Reference translation_of: Web/API/IDBRequest/source --- -
    {{APIRef("IndexedDB")}}
    +{{APIRef("IndexedDB")}} -

    La propriété source est une propriété en lecture seule, rattachée à l'interface {{domxref("IDBRequest")}}, et qui indique la source de la requête (c'est-à-dire l'index ou le magasin d'objets utilisé). Si aucune source n'existe (par exemple car on a appelé {{domxref("indexedDB.open")}}), la propriété vaut null.

    +La propriété **`source`** est une propriété en lecture seule, rattachée à l'interface {{domxref("IDBRequest")}}, et qui indique la source de la requête (c'est-à-dire l'index ou le magasin d'objets utilisé). Si aucune source n'existe (par exemple car on a appelé {{domxref("indexedDB.open")}}), la propriété vaut `null`. -

    {{AvailableInWorkers}}

    +{{AvailableInWorkers}} -

    Syntaxe

    +## Syntaxe -
    var IDBIndex = request.source;
-var IDBCursor = request.source;
-var IDBObjectStore = request.source;
-
    + var IDBIndex = request.source; + var IDBCursor = request.source; + var IDBObjectStore = request.source; -

    Valeur

    +### Valeur -

    Un objet qui représente la source de la requête. Ce peut être un objet {{domxref("IDBIndex")}}, {{domxref("IDBObjectStore")}} ou un objet  {{domxref("IDBCursor")}}.

    +Un objet qui représente la source de la requête. Ce peut être un objet {{domxref("IDBIndex")}}, {{domxref("IDBObjectStore")}} ou un objet  {{domxref("IDBCursor")}}. -

    Exemples

    +## Exemples -

    Dans l'exemple qui suit, on récupère un enregistrement avec un titre donné depuis un magasin d'objets. Ensuite, on met à jour une des propriétés de cet enregistrement et on met à jour le magasin d'objets en insérant cet objet modifié. Lors de cette deuxième requête, on affiche la source dans la console. Pour consulter un exemple fonctionnel complet, vous pouvez vous référer à notre application To-do Notifications (cf. l'exemple live).

    +Dans l'exemple qui suit, on récupère un enregistrement avec un titre donné depuis un magasin d'objets. Ensuite, on met à jour une des propriétés de cet enregistrement et on met à jour le magasin d'objets en insérant cet objet modifié. Lors de cette deuxième requête, on affiche la source dans la console. Pour consulter un exemple fonctionnel complet, vous pouvez vous référer à notre application [To-do Notifications](https://github.com/mdn/to-do-notifications/) ([cf. l'exemple _live_](https://mdn.github.io/to-do-notifications/)). -
    var title = "Walk dog";
+```js
+var title = "Walk dog";
 
 // On ouvre une transaction
 var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList');
@@ -61,42 +61,25 @@ objectStoreTitleRequest.onsuccess = function() {
   // l'affichage
   updateTitleRequest.onsuccess = function() { displayData(); };
 };
-
    - -

    Spécifications

    - - - - - - - - - - - - - - - - - - - -
    SpécificationÉtatCommentaires
    {{SpecName('IndexedDB', '#widl-IDBRequest-source', 'source')}}{{Spec2('IndexedDB')}} 
    {{SpecName("IndexedDB 2", "#dom-idbrequest-source", "source")}}{{Spec2("IndexedDB 2")}} 
    - -

    Compatibilité des navigateurs

    - -

    {{Compat("api.IDBRequest.source")}}

    - -

    Voir aussi

    - - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------ | -------------------------------- | ------------ | +| {{SpecName('IndexedDB', '#widl-IDBRequest-source', 'source')}} | {{Spec2('IndexedDB')}} |   | +| {{SpecName("IndexedDB 2", "#dom-idbrequest-source", "source")}} | {{Spec2("IndexedDB 2")}} |   | + +## Compatibilité des navigateurs + +{{Compat("api.IDBRequest.source")}} + +## Voir aussi + +- [Manipuler IndexedDB](/fr/docs/Web/API/API_IndexedDB/Using_IndexedDB) +- Démarrer des transactions : {{domxref("IDBDatabase")}} +- Manipuler des transactions : {{domxref("IDBTransaction")}} +- Définir un intervalle de clés : {{domxref("IDBKeyRange")}} +- Récupérer des données et les modifier : {{domxref("IDBObjectStore")}} +- Manipuler des curseurs : {{domxref("IDBCursor")}} +- Exemple de référence pour IndexedDB : [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) diff --git a/files/fr/web/api/idbrequest/transaction/index.md b/files/fr/web/api/idbrequest/transaction/index.md index a81f6d0774..1bbf05d769 100644 --- a/files/fr/web/api/idbrequest/transaction/index.md +++ b/files/fr/web/api/idbrequest/transaction/index.md @@ -3,29 +3,30 @@ title: IDBRequest.transaction slug: Web/API/IDBRequest/transaction translation_of: Web/API/IDBRequest/transaction --- -

    {{ APIRef("IndexedDB") }}

    +{{ APIRef("IndexedDB") }} -

    La propriété transaction de l'interface IDBRequest renvoie la {{domxref("IDBTransaction","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 {{domxref("IDBFactory.open")}} dans ce cas on est juste connecté à la base de données.

    +La propriété **`transaction`** de l'interface IDBRequest renvoie la {{domxref("IDBTransaction","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 {{domxref("IDBFactory.open")}} dans ce cas on est juste connecté à la base de données. -
    -

    Note : Durant la gestion d'un événement {{domxref("IDBOpenDBRequest.onupgradeneeded", "upgradeneeded")}} qui met à jour la version de la base de données, la propriété transaction doit être une {{domxref("IDBTransaction","transaction")}} ouverte en {{domxref("IDBTransaction.mode", "mode")}} "versionchange", on peut alors accéder aux {{domxref("IDBObjectStore","magasins d'objets")}} et {{domxref("IDBIndex","index")}} ou annulé la mise à niveau. Après quoi, la propriété transaction renverra encore null.

    -
    +> **Note :** Durant la gestion d'un événement {{domxref("IDBOpenDBRequest.onupgradeneeded", "upgradeneeded")}} qui met à jour la version de la base de données, la propriété **`transaction`** doit être une {{domxref("IDBTransaction","transaction")}} ouverte en {{domxref("IDBTransaction.mode", "mode")}} `"versionchange"`, on peut alors accéder aux {{domxref("IDBObjectStore","magasins d'objets")}} et {{domxref("IDBIndex","index")}} ou annulé la mise à niveau. Après quoi, la propriété **`transaction`** renverra encore `null`. -

    {{AvailableInWorkers}}

    +{{AvailableInWorkers}} -

    Syntaxe

    +## Syntaxe -
    var myTransaction = request.transaction;
    +```js +var myTransaction = request.transaction; +``` -

    Valeur

    +### Valeur -

    Une {{domxref("IDBTransaction","transaction")}}.

    +Une {{domxref("IDBTransaction","transaction")}}. -

    Exemple

    +## Exemple -

    L'exemple suivant demande un titre d'enregistrement donné, onsuccess obtient l'enregistrement associé du {{domxref("IDBObjectStore","magasin d'objects")}} (mis à disposition en tant que objectStoreTitleRequest.result), on met à jour une propriété de l'enregistrement, puis le sauve dans le magasin d'objects. La {{domxref("IDBTransaction","transaction")}} à l'origine de la deuxième {{domxref("IBBRequest","requête")}} est affichée sur la console du développeur (Ps, les deux requêtes proviennent de la même transaction). En bas est une fonction onerror qui affiche le code d'erreur si la requête échoue. Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

    +L'exemple suivant demande un titre d'enregistrement donné, `onsuccess` obtient l'enregistrement associé du {{domxref("IDBObjectStore","magasin d'objects")}} (mis à disposition en tant que `objectStoreTitleRequest.result`), on met à jour une propriété de l'enregistrement, puis le sauve dans le magasin d'objects. La {{domxref("IDBTransaction","transaction")}} à l'origine de la deuxième {{domxref("IBBRequest","requête")}} est affichée sur la console du développeur (Ps, les deux requêtes proviennent de la même transaction). En bas est une fonction onerror qui affiche le code d'erreur si la requête échoue. Pour un exemple de travail complet, voir notre [To-do Notifications](https://github.com/mdn/to-do-notifications/) app ([view example live](http://mdn.github.io/to-do-notifications/)). -
    var title = "Walk dog";
+```js
+var title = "Walk dog";
 
 // Ouvrez une transaction comme d'habitude
 var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList');
@@ -55,21 +56,22 @@ objectStoreTitleRequest.onerror = function() {
   // Si une erreur pendant la requête, on l'affiche
   console.log("Il y a eu une erreur dans la récupération des données: " + objectStoreTitleRequest.error);
 };
-
    +``` -

    Cet exemple montre comment la propriété transaction peut être utilisé pendant une mise à niveau de version pour accéder à des {{domxref("IDBObjectStore","magasins d'objects")}} existants: ​

    +Cet exemple montre comment la propriété **`transaction`** peut être utilisé pendant une mise à niveau de version pour accéder à des {{domxref("IDBObjectStore","magasins d'objects")}} existants: ​ -
    var openRequest = indexedDB.open('db', 2);
+```js
+var openRequest = indexedDB.open('db', 2);
 console.log(openRequest.transaction); // Affiche "null".
 
 openRequest.onupgradeneeded = function(event) {
   console.log(openRequest.transaction.mode); // Affiche "versionchange".
   var db = openRequest.result;
-  if (event.oldVersion < 1) {
+  if (event.oldVersion < 1) {
     // Nouvelle base de données, créer un magasin d'objets "livres".
     db.createObjectStore('books');
   }
-  if (event.oldVersion < 2) {
+  if (event.oldVersion < 2) {
     // Mise à niveau de la base de données v1: ajoute un index sur "title" pour stocker les livres.
     var bookStore = openRequest.transaction.objectStore('books');
     bookStore.createIndex('by_title', 'title');
@@ -79,37 +81,24 @@ openRequest.onupgradeneeded = function(event) {
 openRequest.onsuccess = function() {
   console.log(openRequest.transaction); // Affiche "null".
 };
-
    - -

    Spécifications

    - - - - - - - - - - - - - - -
    SpécificationStatutCommentaire
    {{SpecName('IndexedDB', '#widl-IDBRequest-transaction', 'transaction')}}{{Spec2('IndexedDB')}} 
    - -

    Compatibilité des navigateurs

    - -

    {{Compat("api.IDBRequest.transaction")}}

    - -

    Voir aussi

    - - +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | ---------------------------- | ----------- | +| {{SpecName('IndexedDB', '#widl-IDBRequest-transaction', 'transaction')}} | {{Spec2('IndexedDB')}} |   | + +## Compatibilité des navigateurs + +{{Compat("api.IDBRequest.transaction")}} + +## Voir aussi + +- [Using IndexedDB](/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB) +- Starting transactions: {{domxref("IDBDatabase")}} +- Using transactions: {{domxref("IDBTransaction")}} +- Setting a range of keys: {{domxref("IDBKeyRange")}} +- Retrieving and making changes to your data: {{domxref("IDBObjectStore")}} +- Using cursors: {{domxref("IDBCursor")}} +- Reference example: [To-do Notifications](https://github.com/mdn/to-do-notifications/tree/gh-pages) ([view example live](http://mdn.github.io/to-do-notifications/).) -- cgit v1.2.3-54-g00ecf