blob: 44e80495458848c0a9dff3d2029b7460ba5cebda (
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
|
---
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>
<p>{{Compat("api.IDBFactory.deleteDatabase")}}</p>
<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>
|
