aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/idbfactory/deletedatabase/index.html
blob: 913c6d04c75cb8e3ea95a03fbd8635165679844d (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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
---
title: IDBFactory.deleteDatabase
slug: Web/API/IDBFactory/deleteDatabase
tags:
  - API
  - IDBFactory
  - IndexedDB
  - Storage
  - deleteDatabase
translation_of: Web/API/IDBFactory/deleteDatabase
---
<p>{{ APIRef("IDBFactory") }}</p>
<div>
 <p>{{domxref("IDBFactory")}}インターフェイスの<code>deleteDatabase()</code>メソッドは、データベースの削除を要求します。 このメソッドは直ちに{{domxref("IDBOpenDBRequest")}} オブジェクトを返し、非同期でデータベースの削除処理を行います。</p>
</div>
<p>データベースの削除が成功した場合、 このメソッドから返されたrequestオブジェクトにおいて、resultにnullが設定された状態でsuccessイベントが発生します。 データベースの削除中にエラーが発生した場合、このメソッドから返されたrequestオブジェクトで、errorイベントが発生します。</p>
<h2 id="構文">構文</h2>
<p>現在の標準:</p>
<pre class="brush: js">var request = window.indexedDB.deleteDatabase("toDoList");</pre>
<p><span class="idlInterface"><span class="idlMethod"><code>オプション付の実験バージョン</code> (下を見てください):</span></span></p>
<pre class="brush: js">var request = window.indexedDB.deleteDatabase("toDoList", storage: "temporary");</pre>
<h3 id="戻り値">戻り値</h3>
<p>この要求に関連のある連続したイベントが発生する{{domxref("IDBOpenDBRequest")}}</p>
<h2 id="例"></h2>
<pre class="brush: js">var DBDeleteRequest = window.indexedDB.deleteDatabase("toDoList");

DBDeleteRequest.onerror = function(event) {
  console.log("Error deleting database.");
};

DBDeleteRequest.onsuccess = function(event) {
  console.log("Database deleted successfully");

  console.log(request.result); // should be null
};
</pre>
<h2 id="パラメーター">パラメーター</h2>
<dl>
 <dt>
  name</dt>
 <dd>
  データベース名</dd>
 <dt>
  options {{ NonStandardBadge() }}</dt>
 <dd>
  Geckoの<a href="/en-US/Firefox/Releases/26">version 26</a>から、永続的な(既定値)IndexedDBまたは、一時的なストレージ(shared pool)を削除するための、標準化されていないオプションのストレージパラメーターを含めることができます。</dd>
</dl>
<div class="note">
 <p><strong>Note</strong>: Data in temporary storage persists until the global limit for the pool is reached. The global limit calculation is relatively complex, but we are considering changing it (see  {{ Bug("968272") }}). When the global limit is reached, then data for the least recently used origin is deleted. There's also a group limit (eTLD+1 group/domain) which is currently 20% of the global limit. All requests that would exceed the group limit are just rejected.</p>
</div>
<h2 id="仕様">仕様</h2>
<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('IndexedDB', '#widl-IDBFactory-deleteDatabase-IDBOpenDBRequest-DOMString-name', 'deleteDatabase')}}</td>
   <td>{{Spec2('IndexedDB')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2>
<div>
 {{CompatibilityTable}}</div>
<div id="compat-desktop">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Chrome</th>
    <th>Firefox (Gecko)</th>
    <th>Internet Explorer</th>
    <th>Opera</th>
    <th>Safari (WebKit)</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>23{{property_prefix("webkit")}}<br>
     24</td>
    <td>10 {{property_prefix("moz")}}<br>
     {{CompatGeckoDesktop("16.0")}}</td>
    <td>10, partial</td>
    <td>15</td>
    <td>7.1</td>
   </tr>
  </tbody>
 </table>
</div>
<div id="compat-mobile">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Android</th>
    <th>Firefox Mobile (Gecko)</th>
    <th>Firefox OS</th>
    <th>IE Phone</th>
    <th>Opera Mobile</th>
    <th>Safari Mobile</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>4.4</td>
    <td>{{CompatGeckoMobile("22.0")}}</td>
    <td>1.0.1</td>
    <td>10</td>
    <td>22</td>
    <td>{{CompatNo}}</td>
   </tr>
  </tbody>
 </table>
</div>
<div class="warning">
 <p>Chromeは新しい仕様を実装していますが、旧い仕様も実装したままになっているので注意してください。同じように、ベンダプレフィックスなしのindexedDBがあるにもかかわらず、プレフィックス付きのwebkitIndexedDBも実装しています。</p>
</div>
<h2 id="関連情報">関連情報</h2>
<ul>
 <li><a href="/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB">Using IndexedDB</a></li>
 <li>Starting transactions: {{domxref("IDBDatabase")}}</li>
 <li>Using transactions: {{domxref("IDBTransaction")}}</li>
 <li>Setting a range of keys: {{domxref("IDBKeyRange")}}</li>
 <li>Retrieving and making changes to your data: {{domxref("IDBObjectStore")}}</li>
 <li>Using cursors: {{domxref("IDBCursor")}}</li>
 <li>Reference example: <a class="external" href="https://github.com/mdn/to-do-notifications/tree/gh-pages">To-do Notifications</a> (<a class="external" href="http://mdn.github.io/to-do-notifications/">view example live</a>.)</li>
</ul>