IDBFactory.open

データベースとの接続の間にエラーが発生した場合、このメソッドで返されるrequestオブジェクトで、errorイベントが発生します。

構文

現在の標準：

var request = window.indexedDB.open("toDoList", 4);

オプション付の実験バージョン (下を見てください):

var request = window.indexedDB.open("toDoList", {version: 4, storage: "temporary"});

戻り値

この要求に関連のある連続したイベントが発生するIDBOpenDBRequest オブジェクト。

例外

このメソッドは 次の型のようなDOMErrorを持つDOMExceptionが発生するかもしれません。

例

次のコードスニペットは、 データベースを開く要求をして、成功の場合と失敗の場合のイベントハンドラを登録しています。 完璧に動作する例は、 To-do Notifications app (view example live.)を見てください。

var note = document.querySelector("ul");

// In the following line, you should include the prefixes of implementations you want to test.
window.indexedDB = window.indexedDB || window.mozIndexedDB || window.webkitIndexedDB || window.msIndexedDB;
// DON'T use "var indexedDB = ..." if you're not in a function.
// Moreover, you may need references to some window.IDB* objects:
window.IDBTransaction = window.IDBTransaction || window.webkitIDBTransaction || window.msIDBTransaction;
window.IDBKeyRange = window.IDBKeyRange || window.webkitIDBKeyRange || window.msIDBKeyRange;
// (Mozilla has never prefixed these objects, so we don't need window.mozIDB*)

// Let us open version 4 of our database
var DBOpenRequest = window.indexedDB.open("toDoList", 4);

// these two event handlers act on the database being opened successfully, or not
DBOpenRequest.onerror = function(event) {
  note.innerHTML += '<li>Error loading database.</li>';
};
 
DBOpenRequest.onsuccess = function(event) {
  note.innerHTML += '<li>Database initialised.</li>';
    
  // store the result of opening the database in the db variable. This is used a lot later on, for opening transactions and suchlike.
  db = request.result;
};

パラメーター

name

データベース名。

version

データベースのバージョン。

options (version and storage) 非標準

Geckoのversion 26から, IDBFactory.openのパラメーターとして、データベースのバージョンに加えて、IndexedDBのための永続的な（既定値）ストレージ、または一時的なストレージ（shared pool）のいづれかを指定する非標準のoptionsオブジェクトを含めることができます。

仕様

ブラウザ実装状況

関連情報

• Using IndexedDB
• Starting transactions: IDBDatabase
• Using transactions: IDBTransaction
• Setting a range of keys: IDBKeyRange
• Retrieving and making changes to your data: IDBObjectStore
• Using cursors: IDBCursor
• Reference example: To-do Notifications (view example live.)