aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/idbopendbrequest/blocked_event/index.md
blob: 0e21967b8475d3163b1e67c1f05ce70b732a25bb (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
---
title: blocked
slug: Web/API/IDBOpenDBRequest/blocked_event
translation_of: Web/API/IDBOpenDBRequest/blocked_event
original_slug: Web/API/IDBRequest/blocked_event
---
Le handler **blocked** est exécuté lorsque l'ouverture d'une connexion à une base de données bloque une transaction _versionchange_ sur celle-ci.

## Informations générales

- Spécification
  - : [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)
- Interface
  - : IDBVersionChangeEvent
- Propagation
  - : Non
- Annulable
  - : Non
- Cible
  - : IDBRequest
- Action par défaut
  - : Aucune

## Propriétés

| Property                              | Type                                 | Description                                |
| ------------------------------------- | ------------------------------------ | ------------------------------------------ |
| `target` {{readonlyInline}}     | {{domxref("EventTarget")}} | The request concerned by this event.       |
| `type` {{readonlyInline}}       | {{domxref("DOMString")}}     | The type of event.                         |
| `bubbles` {{readonlyInline}}    | {{jsxref("Boolean")}}         | Whether the event normally bubbles or not. |
| `cancelable` {{readonlyInline}} | {{jsxref("Boolean")}}         | Whether the event is cancellable or not.   |
| `newVersion` {{readonlyInline}} | unsigned long (int)                  | The new version of the database.           |
| `oldVersion` {{readonlyInline}} | unsigned long (int)                  | The old version of the database.           |

## Exemple

```js
var req1 = indexedDB.open("addressbook", 3);

req1.onsuccess = function( event ) {
  var addressbookDB = event.target.result;

  // Essayons d'ouvrir la même base de données avec une version de révision plus élevée
  var req2 = indexedDB.open("addressbook", 4);

  // Dans ce cas, le handler onblocked sera exécuté
  req2.onblocked = function( e ) {
    console.log(e)
  };

};
```

## Evénements liés

- {{event("success")}}
- {{event("error")}}
- {{event("abort")}}
- {{event("complete")}}
- {{event("upgradeneeded")}}
- {{event("blocked")}}
- {{event("versionchange")}}

## Voir aussi

- [Utilisation d'IndexedDB](/fr/docs/IndexedDB/Using_IndexedDB)