aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/idbrequest/onsuccess/index.md
blob: 5e872bcd4200bc07d62f2575394ee505ab9c6338 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
---
title: IDBRequest.onsuccess
slug: Web/API/IDBRequest/onsuccess
translation_of: Web/API/IDBRequest/onsuccess
---
{{ 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 un événement [success](/en-US/docs/Web/Events/success) avec le type="success" en paramètre.

{{AvailableInWorkers}}

## Syntaxe

```js
request.onsuccess = function( event ) { ... };
```

## Exemple

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/)).

    var title = "Walk dog";

    // 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);

    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";

      // 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();
      };
    };

    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écification                                                                                | Statut                       | Commentaire |
| -------------------------------------------------------------------------------------------- | ---------------------------- | ----------- |
| {{SpecName('IndexedDB', '#widl-IDBRequest-onsuccess', 'onsuccess')}} | {{Spec2('IndexedDB')}} |             |

## Compatibilité des navigateurs

{{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/).)