---
title: IDBDatabase.createObjectStore
slug: Web/API/IDBDatabase/createObjectStore
tags:
  - API
  - Database
  - IDBDatabase
  - IndexedDB
  - Storage
  - createObjectStore
translation_of: Web/API/IDBDatabase/createObjectStore
---
<p>{{ APIRef("IDBDatabase") }}</p>

<div>
<p> {{domxref("IDBDatabase")}} インターフェイスの<code>createObjectStore()</code> メソッドは、新しいオブジェクトストアやインデックスを生成して返します。</p>
</div>

<p>このメソッドは、ストアの名前をとるだけでなく、重要なオプションプロパティを定義するためのオプションオブジェクトもとります。ストアの個々のオブジェクトを一意にするために、プロパティを使用できます。 プロパティが識別子ならば、それはすべてのオブジェクトで一意であり、すべてのオブジェクトはそのプロパティを持つべきです。</p>

<p>WebKitブラウザでは、オブジェクトストアやインデックスを生成できるようになる前に、{{ domxref("IDBVersionChangeRequest.setVersion")}}メソッドを呼び出さなければなりません。</p>

<h2 id="構文">構文</h2>

<pre class="notranslate"><em>IDBDatabase</em>.createObjectStore(<em>name</em>);
<em>IDBDatabase</em>.createObjectStore(<em>name</em>, <em>options</em>);</pre>

<h3 id="戻り値">戻り値</h3>

<dl>
 <dt>{{domxref("IDBObjectStore")}}</dt>
 <dd>新しく生成されたオブジェクトストア。</dd>
</dl>

<h3 id="例外">例外</h3>

<p>このメソッドは、次の型の1つを含む{{domxref("DOMError")}}を伴う{{domxref("DOMException")}}を発生させるかもしれません。</p>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Exception</th>
   <th scope="col">Description</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>InvalidStateError</code></td>
   <td>このメソッドが<code>versionchange</code>トランザクションのコールバックとして呼び出されなかった。WebKitブラウザでは、はじめに {{ APIRef("IDBVersionChangeRequest.setVersion")}}を呼び出さなければならない。既に削除されたか取り除かれたオブジェクトを要求した場合も発生する。</td>
  </tr>
  <tr>
   <td><code>ConstraintError</code></td>
   <td>与えられた名前のオブジェクトストア(based on case-sensitive comparison) が接続中のデータベースに既に存在する。</td>
  </tr>
  <tr>
   <td><code>InvalidAccessError</code></td>
   <td><code>autoIncrement</code>がtrueに設定されていて、<code>keyPathが空文字か空文字を含む配列の場合。</code><br>
     </td>
  </tr>
 </tbody>
</table>

<h2 id="例">例</h2>

<pre class="brush: js;highlight:[17] notranslate"> // Let us open our database
  var request = window.indexedDB.open("toDoList", 4);

  // This event handles the event whereby a new version of the database needs to be created
  // Either one has not been created before, or a new version number has been submitted via the
  // window.indexedDB.open line above
  //it is only implemented in recent browsers
  request.onupgradeneeded = function(event) {
    var db = event.target.result;

    db.onerror = function(event) {
      note.innerHTML += '&lt;li&gt;Error loading database.&lt;/li&gt;';
    };

    // Create an objectStore for this database

    var objectStore = db.createObjectStore("toDoList", { keyPath: "taskTitle" });

    // define what data items the objectStore will contain

    objectStore.createIndex("hours", "hours", { unique: false });
    objectStore.createIndex("minutes", "minutes", { unique: false });
    objectStore.createIndex("day", "day", { unique: false });
    objectStore.createIndex("month", "month", { unique: false });
    objectStore.createIndex("year", "year", { unique: false });

    objectStore.createIndex("notified", "notified", { unique: false });

    note.innerHTML += '&lt;li&gt;Object store created.&lt;/li&gt;';
  };</pre>

<h2 id="パラメーター">パラメーター</h2>

<dl>
 <dt>name</dt>
 <dd>新しく作られるオブジェクトストア名。</dd>
 <dt>optionalParameters</dt>
 <dd>
 <p><em>オプション。</em>メソッドのオプションパラメーターとなる属性を持つオプションオブジェクト。これは次のプロパティを持つ。</p>

 <table class="standard-table">
  <thead>
   <tr>
    <th scope="col">Attribute</th>
    <th scope="col">Description</th>
   </tr>
  </thead>
  <tbody>
   <tr>
    <td><code>keyPath</code></td>
    <td>新しいオブジェクトストアで使用される<a href="/en-US/docs/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB#gloss_keypath">key path</a>。空や特定されていない場合、オブジェクトストアはKey Pathなしで生成されて、<a href="/en-US/docs/IndexedDB#gloss_out-of-line_key">out-of-line keys</a>が使用される。</td>
   </tr>
   <tr>
    <td><code>autoIncrement</code></td>
    <td><code>trueだった場合、オブジェクトストアは</code><a href="/en-US/docs/IndexedDB#gloss_key_generator">key generator</a>を持つ。既定値は<code>false。</code></td>
   </tr>
  </tbody>
 </table>

 <p>未知のパラメーターは無視される。</p>
 </dd>
</dl>

<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-IDBDatabase-createObjectStore-IDBObjectStore-DOMString-name-IDBObjectStoreParameters-optionalParameters', 'createObjectStore()')}}</td>
   <td>{{Spec2('IndexedDB')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2>

<p>{{Compat("api.IDBDatabase.createObjectStore")}}</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>