键路径内不允许有空格。
键路径 值只能从由 StructuredSerializeForStorage 显式复制的属性以及以下特定于类型的属性访问：
2.6. 索引 有时通过键 以外的其他方式检索对象存储 中的记录 很有用。索引 允许使用对象存储 记录 中值 的属性来查找对象存储 中的记录 。
索引是一种专门的持久化键值存储，并具有引用的 对象存储 。索引有一个记录列表 ，用于保存存储在索引中的数据。当引用的 对象存储中的记录被插入、更新或删除时，索引中的记录 会自动填充。可以有多个引用同一个对象存储 的索引 ，其中对对象存储的更改会导致所有此类索引得到更新。
索引记录 中的值 总是索引的引用的 对象存储中键 的值。键 使用键路径 从引用的对象存储的值 中推导出来。如果索引引用的对象存储中具有键 X 的给定记录 具有值 A ，并且在 A 上索引的键路径 得出的结果为 Y ，则索引将包含一条键为 Y 、值为 X 的记录。
引用的 对象存储包含一条键为 123、值为 { name: "Alice", title: "CEO" } 的记录，且索引的键路径 为 “name”，则索引将包含一条键为 “Alice”、值为 123 的记录。
索引中的记录被称为具有引用值 。这是索引引用的对象存储中键等于索引记录值的记录的值。因此在上面的示例中，索引中键为 Y 、值为 X 的记录具有值为 A 的引用值 。
Alice”、值为 123 的记录将具有值为 { name: "Alice", title: "CEO" } 的引用值 。
索引中的每条记录仅引用索引引用的 对象存储中的一条记录。但是，索引中可以有多条记录引用同一个对象存储中的同一条记录。而且，索引中也可能没有记录引用对象存储中的给定记录。
索引中的记录 总是根据记录 的键进行排序。然而，与对象存储不同，给定的索引可以包含多条具有相同键的记录。此类记录还会根据索引 记录 的值（即引用对象存储 中记录的键）进行额外排序。
索引 有一个名称 ，是一个名称 。在任何时候，该名称在索引引用的 对象存储 内都是唯一的。
索引 有一个唯一标志 。设置此标志后，索引会强制要求索引中没有两条记录 具有相同的键。如果尝试插入或修改索引引用的对象存储中的一条记录 ，使得在记录的新值上评估索引的键路径得到的结果已在索引中存在，则对对象存储的修改尝试将失败。
索引 有一个多条目标志 。当评估索引的键路径 的结果产生一个数组键 时，此标志会影响索引的行为。如果多条目标志 未设置，则将单个记录 （其键 是一个数组键 ）添加到索引中。如果多条目标志 为 true，则为每个子键 添加一条记录 到索引中。
2.6.1. 索引句柄 脚本不会直接与索引 交互。相反，在事务 内，脚本通过索引句柄 进行间接访问。
2.7. 事务 事务 用于与数据库 中的数据交互。每当对数据库进行读写操作时，都是通过事务 完成的。
事务 提供了一些防止应用和系统故障的保护措施。事务 可用于存储多条数据记录或有条件地修改某些数据记录。事务 代表了一组原子且持久的数据访问和数据变更操作。
所有事务都通过连接 创建，这是事务的连接 。
事务 有一个作用域 ，它决定了事务可以与之交互的对象存储 。事务的作用域在事务的整个生命周期内保持不变。
事务 有一个模式 ，决定了可以在该事务上执行哪些类型的交互。模式 在事务创建时设置，并在事务的整个生命周期内保持不变。事务 的模式 是以下之一：
"readonly" 事务只允许读取数据。此类事务不能进行修改。这有一个好处：即使作用域 重叠（即使用相同的对象存储），也可以同时运行多个只读事务 。这种类型的事务可以在数据库打开后的任何时候创建。 "readwrite" 事务允许读取、修改和删除现有对象存储中的数据。但是，不能添加或删除对象存储和索引。如果作用域 重叠，则多个 "readwrite" "versionchange" 事务允许读取、修改和删除现有对象存储中的数据，还可以创建和删除对象存储和索引。这是唯一可以执行此类操作的事务类型。这种类型的事务不能手动创建，而是当 upgradeneeded
事务 有一个活动标志 ，决定是否可以对该事务发出新的请求 。如果事务的活动标志 已设置，则称该事务为活动 。
事务 可选地具有一个清理事件循环 ，它是一个事件循环 。
事务 有一个已对该事务发出的请求 的请求列表 。
事务 有一个错误 ，如果事务 被终止 ，则该属性被设置。
事务 的获取父级 算法返回该事务的连接 。
只读事务 是模式为 "readonly" 事务 。
读/写事务 是模式为 "readwrite" 事务 。
2.7.1. 事务生命周期 事务应尽可能简短。下述的自动提交 功能对此进行了鼓励。
要清理 Indexed Database 事务 ，请对每个事务 ，其 清理事件循环 (cleanup event loop) 与当前事件循环 (event loop) 相匹配的，执行以下步骤。
2.7.2. 升级事务 (Upgrade Transactions) 升级事务 (upgrade transaction) 是模式 (mode) 为 "versionchange" 事务 。
当连接 (connection) 到数据库 并指定了大于当前版本 (version) 的版本号时，在执行运行升级事务 的步骤后，会自动创建升级事务 。此事务 将在 upgradeneeded
2.8. 请求 (Requests) 对数据库 的每次异步操作都是使用请求 (request) 完成的。每个请求代表一个操作。
2.9. 键范围 (Key Range) 可以使用键 (keys) 或键范围 (key ranges) 从对象存储 和索引 中检索记录。键范围 是某种用于键的数据类型上的连续区间。
键范围 有一个关联的下界 (lower bound) （null 或一个键 ）。
键范围 有一个关联的上界 (upper bound) （null 或一个键 ）。
键范围 有一个关联的下界开放标志 (lower open flag) 。除非另有说明，否则它处于未设置状态。
键范围 有一个关联的上界开放标志 (upper open flag) 。除非另有说明，否则它处于未设置状态。
键范围 的下界 可以等于 (equal to) 其上界 。键范围 的下界 不得大于 (greater than) 其上界 。
仅包含 (containing only) key 的键范围 的下界 和上界 都等于 key 。
如果满足以下两个条件，则key 处于键范围中 (in a key range)
无界键范围 (unbounded key range) 是一个键范围 ，其下界 和上界 均等于 null。所有键 都处于 无界键范围 中。
2.10. 游标 (Cursor) 游标 (cursor) 用于以特定方向迭代索引 或对象存储 中的一系列记录。
游标 有一个事务 ，即创建游标时活动 的事务 。
游标 有一个记录范围 (range) ，位于索引 或对象存储 中。
游标 有一个源 (source) ，指示哪个索引 或对象存储 与游标正在迭代的记录相关联。
游标 有一个方向 (direction) ，决定了迭代时是按单调递增还是单调递减的记录 键移动，以及在迭代索引时是否跳过重复值。游标的方向也决定了游标的初始位置是在其源 的开头还是结尾。游标的方向 是以下之一：
"next" 此方向使游标从源 的开头打开。迭代时，游标 应以键的单调递增顺序产生所有记录，包括重复项。 "nextunique" 此方向使游标从源 的开头打开。迭代时，游标 不应产生具有相同键的记录，但在其他方面应以键的单调递增顺序产生所有记录。对于每个具有重复值的键，只产生第一条记录。当源 是对象存储 或已设置唯一性标志 (unique flag) 的索引 时，此方向的行为与 "next" "prev" 此方向使游标从源 的结尾打开。迭代时，游标 应以键的单调递减顺序产生所有记录，包括重复项。 "prevunique" 此方向使游标从源 的结尾打开。迭代时，游标 不应产生具有相同键的记录，但在其他方面应以键的单调递减顺序产生所有记录。对于每个具有重复值的键，只产生第一条记录。当源 是对象存储 或已设置唯一性标志 的索引 时，此方向的行为与 "prev"
游标 在其范围内有一个位置 (position) 。游标正在迭代的记录列表可能会在游标的全部范围 被迭代之前发生变化。为了处理这个问题，游标维持其位置 时，不是以索引形式，而是以上一次返回记录的键 形式。对于前向迭代的游标，下次请求迭代到下一条记录时，它返回大于 上一次返回的键的最小键 的记录。对于后向迭代的游标，情况正好相反，它返回小于 上一次返回的键的最大键 的记录。
对于迭代索引的游标，情况要复杂一些，因为多条记录可以具有相同的键，因此它们也按值 (value) 排序。当迭代索引时，游标 还有一个对象存储位置 (object store position) ，它指示索引中先前找到的记录 的值 。在寻找下一条合适记录时，位置 和对象存储位置 都会被使用。
游标 有一个键 和一个值 ，代表最后一次迭代的记录 的键 和值 。
游标 有一个获得值标志 (got value flag) 。当此标志未设置时，游标要么正在加载下一个值，要么已到达其范围 的末尾。当它已设置时，表示游标当前持有一个值，并准备好迭代到下一个值。
如果游标的源 是对象存储 ，则游标的有效对象存储 (effective object store) 就是该对象存储，而游标的有效键 (effective key) 就是该游标的位置 。如果游标的源 是索引 ，则游标的有效对象存储 就是该索引所引用的 对象存储，而有效键 是该游标的对象存储位置 。
游标 还有一个仅键标志 (key only flag) ，指示游标的值 是否通过 API 公开。除非另有说明，否则它处于未设置状态。
2.11. 键生成器 (Key Generators) 创建对象存储 时，可以指定使用键生成器 (key generator) 。如果未另行指定，键生成器用于为插入到对象存储中的记录生成键。
键生成器 有一个当前编号 (current number) 。当前编号 始终是一个小于或等于 253 (9007199254740992) + 1 的正整数。键生成器 当前编号 的初始值为 1，在关联的对象存储 创建时设置。当前编号 随着键的生成而递增，并且可以通过使用显式键更新为特定值。
每个使用键生成器的对象存储都使用单独的生成器。也就是说，与一个对象存储的交互绝不会影响任何其他对象存储的键生成器。
修改键生成器的当前编号 被视为数据库操作的一部分。这意味着如果操作失败且操作被还原，当前编号 将还原为操作开始前的值。这既适用于由于使用键生成器导致当前编号 增加 1 而发生的修改，也适用于由于使用在存储记录 的调用中指定的键值来存储记录 而发生的修改。
同样，如果事务 被中止，事务作用域 内每个对象存储 的键生成器的当前编号 将还原为事务 开始前的值。
键生成器的当前编号 从不减小，除非是因为数据库操作被还原。从对象存储 中删除记录 绝不会影响对象存储的键生成器。即使清除对象存储中的所有记录（例如使用 clear() 当前编号 。
当存储记录 且在调用存储记录时未指定键 时，将生成一个键。
要为对象存储 store 生成键 ，请执行以下步骤：
令 generator 为与 store 关联的键生成器 。
令 key 为 generator 的当前编号 。
如果 key 大于 253 (9007199254740992)，则返回失败。
将 generator 的当前编号 增加 1。
返回 key 。
当存储记录 且在调用存储记录时指定了键 时，关联的键生成器 可能会被更新。
要为对象存储 store 可能更新键生成器 （使用 key ），请执行以下步骤：
如果 key 的类型 不是 number ，则中止这些步骤。
令 value 为 key 的值 。
令 value 为 value 和 253 (9007199254740992) 中的较小值。
令 value 为不大于 value 的最大整数。
令 generator 为与 store 关联的键生成器 。
如果 value 大于或等于 generator 的当前编号 ，则将 generator 的当前编号 设置为 value + 1。
当键生成器的当前编号 超过值 253 (9007199254740992) 时，任何后续尝试使用该键生成器生成新键 的行为都将导致 "ConstraintError DOMException 记录 插入到对象存储中，但是对于此类记录，再次使用键生成器的唯一方法是删除对象存储并创建一个新的。
此限制产生的原因是大于 9007199254740992 的整数无法作为 ECMAScript 数字 (Numbers) 唯一表示。例如，在 ECMAScript 中，9007199254740992 + 1 === 9007199254740992。只要按正常方式使用键生成器，这个限制就不会成为问题。如果您日夜不停地每秒生成一个新键，超过 285,000 年都不会遇到这个限制。
实际的结果是，为对象存储生成的第一个键始终是 1（除非首先插入了更高的数字键），并且为对象存储生成的键始终是大于存储中最高数字键的正整数。同一个键永远不会为同一个对象存储生成两次，除非事务被回滚。
每个对象存储都有自己的键生成器。
store1 = db. createObjectStore( "store1" , { autoIncrement: true });
store1. put( "a" ); // Will get key 1
= db. createObjectStore( "store2" , { autoIncrement: true });
store2. put( "a" ); // Will get key 1
. put( "b" ); // Will get key 2
. put( "b" ); // Will get key 2
如果插入因约束违规或 IO 错误而失败，则不会更新键生成器。
transaction. onerror = function ( e) { e. preventDefault() };
store = db. createObjectStore( "store1" , { autoIncrement: true });
index = store. createIndex( "index1" , "ix" , { unique: true });
store. put({ ix: "a" }); // Will get key 1
. put({ ix: "a" }); // Will fail
. put({ ix: "b" }); // Will get key 2
从 objectStore 中删除项目绝不会影响键生成器。包括调用 clear()
store = db. createObjectStore( "store1" , { autoIncrement: true });
store. put( "a" ); // Will get key 1
. delete ( 1 );
store. put( "b" ); // Will get key 2
. clear();
store. put( "c" ); // Will get key 3
. delete ( IDBKeyRange. lowerBound( 0 ));
store. put( "d" ); // Will get key 4
插入带有显式键的项目当且仅当键是数字且高于最后生成的键时，才会影响键生成器。
store = db. createObjectStore( "store1" , { autoIncrement: true });
store. put( "a" ); // Will get key 1
. put( "b" , 3 ); // Will use key 3
. put( "c" ); // Will get key 4
. put( "d" , - 10 ); // Will use key -10
. put( "e" ); // Will get key 5
. put( "f" , 6.00001 ); // Will use key 6.0001
. put( "g" ); // Will get key 7
. put( "f" , 8.9999 ); // Will use key 8.9999
. put( "g" ); // Will get key 9
. put( "h" , "foo" ); // Will use key "foo"
. put( "i" ); // Will get key 10
. put( "j" , [ 1000 ]); // Will use key [1000]
. put( "k" ); // Will get key 11
// All of these would behave the same if the objectStore used a
// keyPath and the explicit key was passed inline in the object
中止事务会回滚事务期间发生的对键生成器的任何增加。这是为了使所有回滚保持一致，因为因崩溃而发生的回滚永远没有机会提交已增加的键生成器值。
db. createObjectStore( "store" , { autoIncrement: true });
trans1 = db. transaction([ "store" ], "readwrite" );
store_t1 = trans1. objectStore( "store" );
store_t1. put( "a" ); // Will get key 1
. put( "b" ); // Will get key 2
. abort();
trans2 = db. transaction([ "store" ], "readwrite" );
store_t2 = trans2. objectStore( "store" );
store_t2. put( "c" ); // Will get key 1
. put( "d" ); // Will get key 2
以下示例说明了尝试使用行内键 和键生成器 将对象保存到对象存储 时的不同行为。
如果满足以下条件：
那么，键生成器 提供的值将用于填充键值。在下面的示例中，对象存储的键路径 是 "foo.bar"。实际对象没有 bar 属性的值，即 { foo: {} }。当对象保存在对象存储 中时，bar 属性被赋予值 1，因为这是由键生成器 生成的下一个键 。
var store = db. createObjectStore( "store" , { keyPath: "foo.bar" ,
autoIncrement: true });
store. put({ foo: {} }). onsuccess = function ( e) {
var key = e. target. result;
console. assert( key === 1 );
};
如果满足以下条件：
那么使用与键路径 属性关联的值。不使用自动生成的键 。在下面的示例中，对象存储 的键路径 是 "foo.bar"。实际对象对于 bar 属性的值为 10，即 { foo: { bar: 10} }。当对象保存在对象存储 中时，bar 属性保持其值 10，因为那是键值。
var store = db. createObjectStore( "store" , { keyPath: "foo.bar" ,
autoIncrement: true });
store. put({ foo: { bar: 10 } }). onsuccess = function ( e) {
var key = e. target. result;
console. assert( key === 10 );
};
以下示例说明了当指定的行内键 是通过键路径 定义的，但没有与之匹配的属性时的场景。此时，键生成器 提供的值将被用于填充键值，并且系统负责创建它所需的尽可能多的属性以满足层次链上的属性依赖关系。在下面的示例中，对象存储 的键路径 是 "foo.bar.baz"。实际对象对于 foo 属性没有值，即 { zip: {} }。当对象保存在对象存储 中时，将创建 foo、bar 和 baz 属性，每个属性都作为另一个的子属性，直到可以为 foo.bar.baz 赋值。foo.bar.baz 的值是对象存储生成的下一个键。
var store = db. createObjectStore( "store" , { keyPath: "foo.bar.baz" ,
autoIncrement: true });
store. put({ zip: {} }). onsuccess = function ( e) {
var key = e. target. result;
console. assert( key === 1 );
store. get( key). onsuccess = function ( e) {
var value = e. target. result;
// value will be: { zip: {}, foo: { bar: { baz: 1 } } }
. assert( value. foo. bar. baz === 1 );
};
};
尝试在原始值（primitive value）上存储属性将会失败并抛出错误。在下面的第一个示例中，对象存储的键路径 是 "foo"。实际对象是一个值为 4 的原始值。尝试在该原始值上定义属性会失败。数组也是如此。数组上不允许定义属性。在下面的第二个示例中，实际对象是一个数组 [10]。尝试在该数组上定义属性会失败。
var store = db. createObjectStore( "store" , { keyPath: "foo" , autoIncrement: true });
// The key generation will attempt to create and store the key path
// property on this primitive.
. put( 4 ); // will throw DataError
// The key generation will attempt to create and store the key path
// property on this array.
. put([ 10 ]); // will throw DataError
3. 异常 (Exceptions) 本文档中使用的每个异常都是具有特定类型的 DOMException [WEBIDL] 中定义。
下表列出了本文档中使用的 DOMException
鉴于多个 Indexed DB 操作可能抛出相同类型的错误，且即使是单个操作也可能因多种原因抛出相同类型的错误，我们鼓励实现提供更具体的提示消息，以便开发者能够识别错误原因。
4. API API 方法在不阻塞调用线程的情况下返回。所有异步操作会立即返回一个 IDBRequest IDBRequest
这些任务的 任务源 (task source) 是 数据库访问任务源 (database access task source) 。
IDBRequest 事件处理程序 IDL 属性 [HTML52] 访问针对数据库 和数据库 对象的异步请求结果的方法。
每个用于发出异步请求的方法都会返回一个 IDBRequest 数据库 上都可以同时激活任意数量的请求。
在下面的示例中，我们异步打开一个数据库 。注册了各种事件处理程序以响应不同情况。
var request = indexedDB. open( 'AddressBook' , 15 );
request. onsuccess = function ( evt) {...};
request. onerror = function ( evt) {...};
[Exposed =(Window ,Worker )]
interface IDBRequestEventTarget {
readonly attribute any result ;
readonly attribute DOMException ? error ;
readonly attribute (IDBObjectStore or IDBIndex or IDBCursor )? source ;
readonly attribute IDBTransaction ? transaction ;
readonly attribute IDBRequestReadyState readyState ;
// Event handlers:
attribute EventHandler onsuccess ;
attribute EventHandler onerror ;
};
enum IDBRequestReadyState"pending""done"
result完成标志 未设置，则必须抛出 "InvalidStateError DOMException 结果 ，或者如果请求导致错误则返回 undefined。
error完成标志 未设置，则必须抛出 "InvalidStateError DOMException 错误 ，或者如果未发生错误则返回 null。
source请求 的源 ，如果未设置源 则返回 null。
transaction请求 的事务 。对于某些请求（例如从 open() 请求 ），此属性可以为 null。
readyState完成标志 未设置，则必须返回 "pending" "done"
onsuccesssuccess 事件的事件处理程序。
onerrorerror 事件的事件处理程序。
IDBDatabase 打开请求 的方法使用扩展接口，以允许监听 blocked upgradeneeded
[Exposed =(Window ,Worker )]
interface IDBOpenDBRequestIDBRequest {
// Event handlers:
attribute EventHandler onblocked ;
attribute EventHandler onupgradeneeded ;
};
onblockedblocked
onupgradeneededupgradeneeded
4.2. 事件接口 (Event interfaces) 本规范使用以下自定义接口触发事件：
[Exposed =(Window ,Worker ),
ConstructorDOMString typeoptional IDBVersionChangeEventInit eventInitDictinterface IDBVersionChangeEventEvent {
readonly attribute unsigned long long oldVersion ;
readonly attribute unsigned long long newVersion ;
};
dictionary IDBVersionChangeEventInitEventInit {
unsigned long long oldVersionunsigned long long newVersionnull ;
};
oldVersion
newVersion运行升级事务 的步骤。
事件根据 [DOM41] 中的 构建事件 (Constructing events) 进行构建。
要在给定 oldVersion 和 newVersion 的情况下，向 target 触发名为 e 的 版本变更事件 (version change event) ，请执行以下步骤：
令 event 为使用 IDBVersionChangeEvent 创建事件 的结果。
将 event 的 type e 。
将 event 的 bubbles cancelable
将 event 的 oldVersion oldVersion 。
将 event 的 newVersion newVersion 。
令 legacyOutputDidListenersThrowFlag 为未设置状态。
在 target 上分发 (Dispatch) event ，并带有 legacyOutputDidListenersThrowFlag 。
返回 legacyOutputDidListenersThrowFlag 。
数据库 对象通过 IDBFactory
partial interface WindowOrWorkerGlobalScope {
[SameObject ] readonly attribute IDBFactory indexedDB ;
};
indexedDB
[Exposed =(Window ,Worker )]
interface IDBFactoryNewObject ] IDBOpenDBRequest open (DOMString nameoptional [EnforceRange ] unsigned long long versionNewObject ] IDBOpenDBRequest deleteDatabase (DOMString nameshort cmp (any firstany second
request = indexedDB . open name )尝试使用当前版本打开与已命名数据库 的连接 ，如果它尚不存在，则版本号为 1。如果请求成功，request 的 result 连接 。 request = indexedDB . open name , version )尝试以指定的版本打开 指定名称的数据库 连接 。如果数据库已存在且版本较低，且存在未响应 versionchange 事件而关闭的打开连接 ，则该请求将被阻塞 ，直到它们全部关闭，随后将执行升级。如果数据库已存在且版本较高，则请求将失败。如果请求成功，则 request 的 result 连接 。 request = indexedDB . deleteDatabase name )尝试删除指定名称的数据库 。如果数据库已存在，且存在未响应 versionchange 事件而关闭的打开连接 ，则该请求将被阻塞 ，直到它们全部关闭。如果请求成功，则 request 的 result
result = indexedDB . cmp key1 , key2 )将两个值作为键 进行比较。如果 key1 排在 key2 之前返回 -1，如果 key2 排在 key1 之前返回 1，如果键相等则返回 0。如果任一输入不是有效的键 ，则抛出 "DataError DOMException
IDBDatabase 数据库 的连接 。
如果 IDBDatabase 关闭挂起标志 未设置，且其注册了一个或多个类型为 abort、error 或 versionchange 的事件监听器，则该对象不得被垃圾回收。如果一个 IDBDatabase 连接 必须被关闭 。
[Exposed =(Window ,Worker )]
interface IDBDatabaseEventTarget {
readonly attribute DOMString name ;
readonly attribute unsigned long long version ;
readonly attribute DOMStringList objectStoreNames ;
[NewObject ] IDBTransaction transaction ((DOMString or sequence <DOMString storeNamesoptional IDBTransactionMode modevoid close ();
[NewObject ] IDBObjectStore createObjectStore (DOMString nameoptional IDBObjectStoreParameters optionsvoid deleteObjectStore (DOMString nameattribute EventHandler onabort ;
attribute EventHandler onclose ;
attribute EventHandler onerror ;
attribute EventHandler onversionchange ;
};
dictionary IDBObjectStoreParametersDOMString or sequence <DOMString keyPathnull ;
boolean autoIncrementfalse ;
};
name已连接 数据库 的名称 。即使在连接上设置了关闭挂起标志 ，该属性也必须返回此名称。换句话说，此属性的值在 IDBDatabase
version连接 的版本 。
这与数据库 的版本 相同吗？ 只要连接 处于打开状态，它就与已连接数据库 的版本 相同。但一旦连接 已关闭 ，此属性将不会反映稍后通过升级事务 所做的更改。
objectStoreNamesDOMStringList 连接 的对象存储集合 中对象存储 名称 的排序名称列表 。
这与数据库 的对象存储 名称 相同吗？ 只要连接 处于打开状态，它就与已连接数据库 的对象存储 名称 相同。但一旦连接 已关闭 ，此属性将不会反映稍后通过升级事务 所做的更改。
此方法在已连接 数据库 中创建一个具有给定名称的新对象存储 并返回。注意，此方法只能在升级事务 内调用。
此方法同步修改被调用时所在的 IDBDatabase objectStoreNames
在某些实现中，createObjectStore() 对象存储 的任务后，可能会遇到问题。例如，在某些实现中，关于新创建对象存储 的元数据是异步插入数据库的，或者实现可能因配额原因需要征求用户许可。此类实现仍必须创建并返回一个 IDBObjectStore 对象存储 已失败，必须使用适当的错误中止事务 。例如，如果由于配额原因导致创建对象存储 失败，则必须将 "QuotaExceededError DOMException
此方法销毁已连接 数据库 中具有给定名称的对象存储 。注意，此方法只能在升级事务 内调用。
此方法同步修改被调用时所在的 IDBDatabase objectStoreNames
所创建的 transaction 将遵循生命周期 规则。
onabortabort 事件的事件处理程序。
oncloseclose 事件的事件处理程序。
🚧 onclose
onerrorerror 事件的事件处理程序。
onversionchangeversionchange 事件的事件处理程序。
IDBObjectStore 对象存储句柄 。
[Exposed =(Window ,Worker )]
interface IDBObjectStoreattribute DOMString name ;
readonly attribute any keyPath ;
readonly attribute DOMStringList indexNames ;
[SameObject ] readonly attribute IDBTransaction transaction ;
readonly attribute boolean autoIncrement ;
[NewObject ] IDBRequest put (any valueoptional any keyNewObject ] IDBRequest add (any valueoptional any keyNewObject ] IDBRequest delete (any queryNewObject ] IDBRequest clear ();
[NewObject ] IDBRequest get (any queryNewObject ] IDBRequest getKey (any queryNewObject ] IDBRequest getAll (optional any queryoptional [EnforceRange ] unsigned long countNewObject ] IDBRequest getAllKeys (optional any queryoptional [EnforceRange ] unsigned long countNewObject ] IDBRequest count (optional any queryNewObject ] IDBRequest openCursor (optional any queryoptional IDBCursorDirection directionNewObject ] IDBRequest openKeyCursor (optional any queryoptional IDBCursorDirection directionIDBIndex index (DOMString nameNewObject ] IDBIndex createIndex (DOMString nameDOMString or sequence <DOMString keyPathoptional IDBIndexParameters optionsvoid deleteIndex (DOMString namedictionary IDBIndexParametersboolean uniquefalse ;
boolean multiEntryfalse ;
};
name对象存储句柄 的名称 。
这与对象存储 的名称 相同吗？ 只要事务 尚未完成 ，它就与关联的对象存储 的名称 相同。但一旦事务 已完成 ，此属性将不会反映稍后通过升级事务 所做的更改。
🚧 name
keyPath对象存储句柄 的对象存储 的键路径 ，如果没有则返回 null。根据 [WEBIDL] ，键路径 被转换为 DOMString sequence<DOMString> （如果是一个字符串列表）。
返回值并非对象存储 创建时所使用的同一个实例。然而，如果该属性返回一个对象（特别是 Array ），它每次被检查时都会返回相同的对象实例。更改该对象的属性不会对对象存储 产生影响。
indexNamesDOMStringList 对象存储句柄 的索引集合 中索引 名称 的排序名称列表 。
这与对象存储 的索引 名称 列表相同吗？ 只要事务 尚未完成 ，它就与关联的对象存储 的索引 名称 列表相同。但一旦事务 已完成 ，此属性将不会反映稍后通过升级事务 所做的更改。
transaction对象存储句柄 的事务 。
autoIncrement对象存储句柄 的对象存储 具有键生成器 ），否则返回 false。
query 参数可以是标识要删除的记录 键的键 或 IDBKeyRange 与其他接受键或键范围的方法不同，此方法不 允许将 null 作为键传入。这是为了降低因小错误而清除整个对象存储的风险。
query 参数可以是一个键 或一个标识要检索的记录 的 IDBKeyRange
如果带有给定键的记录不存在，或者记录存在但其值为 undefined，此方法产生的结果相同。如果您需要区分这两种情况，可以使用带有相同键的 openCursor() undefined）的游标；如果不存在此类记录，则不返回游标。
query 参数可以是一个键 或一个标识要检索的记录 键的 IDBKeyRange
query 参数可以是一个键 或一个标识要检索的记录 的 IDBKeyRange 无界键范围 。如果指定了 count 且范围内的记录数超过 count ，则仅检索前 count 条记录。
🚧 getAll()
query 参数可以是一个键 或一个标识要检索的记录 键的 IDBKeyRange 无界键范围 。如果指定了 count 且范围内的键数超过 count ，则仅检索前 count 个键。
🚧 getAllKeys()
query 参数可以是一个键 或一个标识要统计的记录 键的 IDBKeyRange 无界键范围 。
query 参数可以是一个键 或一个用作游标 的范围 的 IDBKeyRange 无界键范围 。
query 参数可以是一个键 或一个用作游标 的范围 的 IDBKeyRange 无界键范围 。
🚧 openKeyCursor()
此方法在对象存储 中创建并返回一个具有给定名称的新索引 。注意，此方法只能在升级事务 内调用。
请求创建的索引可以包含对索引所引用 的对象存储中允许的数据的约束，例如要求索引的 keyPath 所引用的值具有唯一性。如果所引用 的对象存储已经包含违反这些约束的数据，这绝不能导致 createIndex() IDBIndex 将一个任务加入队列 ，以中止用于 createIndex() 升级事务 。
此方法同步修改调用它的 IDBObjectStore indexNames IDBRequest 升级事务 内作为异步请求处理的。
在某些实现中，createIndex 方法返回后，实现可能会异步遇到创建索引的问题。例如，在有关新创建索引的元数据被排队以异步插入数据库的实现中，或者实现因配额原因需要询问用户许可的情况。此类实现仍必须创建并返回一个 IDBIndex 中止事务 的步骤并使用适当的错误作为 error 来中止事务。例如，如果创建索引 因配额原因失败，则必须将 "QuotaExceededError DOMException 唯一标志 约束无法创建索引，则必须将 "ConstraintError DOMException
索引的异步创建在以下示例中是可观察的
var request1 = objectStore. put({ name: "betty" }, 1 );
var request2 = objectStore. put({ name: "betty" }, 2 );
var index = objectStore. createIndex( "by_name" , "name" , { unique: true });
在调用 createIndex() 请求 都尚未执行。当第二个请求执行时，会创建一个重复的名称。由于索引创建被视为异步请求 ，因此索引的唯一性约束 不会导致第二个请求 失败。相反，当索引被创建且约束检查失败时，事务 将被中止 。
在同一个 IDBObjectStore IDBIndex 返回的 IDBIndex IDBObjectStore IDBObjectStore IDBIndex 此方法销毁对象存储 中具有给定名称的索引 。注意，此方法只能在升级事务 内调用。
此方法同步修改调用它的 IDBObjectStore indexNames IDBRequest 升级事务 内作为异步请求处理的。
IDBIndex 索引句柄 。
[Exposed =(Window ,Worker )]
interface IDBIndexattribute DOMString name ;
[SameObject ] readonly attribute IDBObjectStore objectStore ;
readonly attribute any keyPath ;
readonly attribute boolean multiEntry ;
readonly attribute boolean unique ;
[NewObject ] IDBRequest get (any queryNewObject ] IDBRequest getKey (any queryNewObject ] IDBRequest getAll (optional any queryoptional [EnforceRange ] unsigned long countNewObject ] IDBRequest getAllKeys (optional any queryoptional [EnforceRange ] unsigned long countNewObject ] IDBRequest count (optional any queryNewObject ] IDBRequest openCursor (optional any queryoptional IDBCursorDirection directionNewObject ] IDBRequest openKeyCursor (optional any queryoptional IDBCursorDirection direction
name索引句柄 的名称 。
这与索引 的名称 相同吗？只要事务 没有完成 ，这与关联的索引 的名称 相同。但一旦事务 完成 ，此属性将不会反映稍后在升级事务 中所做的更改。
🚧 name
objectStore索引句柄 的对象存储句柄 。
keyPath索引句柄 的索引 的键路径 。根据 [WEBIDL] ，键路径 被转换为 DOMString sequence<DOMString> （如果是字符串列表）。
返回的值并非创建索引 时所使用的相同实例。但是，如果此属性返回一个对象（特别是 Array ），它每次被检查时都会返回相同的对象实例。更改对象的属性对索引 没有任何影响。
multiEntry索引句柄 的索引 的多条目标志 时返回 true，否则返回 false。
unique索引句柄 的索引 的唯一标志 时返回 true，否则返回 false。
query 参数可以是一个键 或一个标识要检索的记录 的 IDBKeyRange 如果记录存在但其值为 undefined，或者记录不存在，则此方法产生的结果相同。如果您需要区分这两种情况，可以使用带有相同键的 openCursor() undefined）的游标；如果不存在此类记录，则不返回游标。
query 参数可以是一个键 或一个标识要检索的记录 键的 IDBKeyRange
query 参数可以是一个键 或一个标识要检索的记录 的 IDBKeyRange 无界键范围 。如果指定了 count 且范围内的记录数超过 count ，则仅检索前 count 条记录。
🚧 getAll() query 参数可以是键 或用于标识待检索记录 键的 IDBKeyRange 无界键范围 。如果指定了 count 且范围内的键多于 count 个，则仅检索前 count 个。
🚧 getAllKeys()
query 参数可以是键 或用于标识待计数记录 键的 IDBKeyRange 无界键范围 。
query 参数可以是键 或用作游标 范围 的 IDBKeyRange 无界键范围 。
query 参数可以是键 或用作游标 范围 的 IDBKeyRange 无界键范围 。
IDBKeyRange 键范围 。
[Exposed =(Window ,Worker )]
interface IDBKeyRangereadonly attribute any lower ;
readonly attribute any upper ;
readonly attribute boolean lowerOpen ;
readonly attribute boolean upperOpen ;
// Static construction methods:
[NewObject ] static IDBKeyRange only (any valueNewObject ] static IDBKeyRange lowerBoundany loweroptional boolean openfalse );
[NewObject ] static IDBKeyRange upperBoundany upperoptional boolean openfalse );
[NewObject ] static IDBKeyRange bound (any lowerany upperoptional boolean lowerOpenfalse ,
optional boolean upperOpenfalse );
boolean _includesany key
注意： 将 _includes 标识符映射到 ECMAScript 时，应移除前导的 U+005F LOW LINE ("_") 字符。使用前导的 "_" 是为了转义该标识符，使其看起来不像是保留字（此处为 includes 关键字）。
lower下界 不为 null，则返回执行将键转换为值 步骤的结果，否则返回 undefined。
upper上界 不为 null，则返回执行将键转换为值 步骤的结果，否则返回 undefined。
lowerOpen下界开放标志 时返回 true，否则返回 false。
upperOpen上界开放标志 时返回 true，否则返回 false。
range . includes key )如果范围中包含 key 则返回 true，否则返回 false。
🚧 includes()
游标 对象实现了 IDBCursor 游标 的 IDBCursor
[Exposed =(Window ,Worker )]
interface IDBCursorreadonly attribute (IDBObjectStore or IDBIndex ) source ;
readonly attribute IDBCursorDirection direction ;
readonly attribute any key ;
readonly attribute any primaryKey ;
void advance ([EnforceRange ] unsigned long countvoid continue (optional any keyvoid continuePrimaryKey (any keyany primaryKeyNewObject ] IDBRequest update (any valueNewObject ] IDBRequest delete ();
};
enum IDBCursorDirection"next""nextunique""prev""prevunique"
source游标 的来源 。此属性永远不会返回 null 或抛出异常，即使游标当前正在迭代、已迭代过末尾或其事务 不处于活动状态 。
direction游标 的方向 。
key键 执行将键转换为值 步骤的结果。注意，如果该属性返回对象（例如 Date 或 Array ），则每次检查它时都会返回相同的对象实例，直到游标的键 发生变化。这意味着如果对象被修改，任何检查游标值的人都会看到这些修改。然而，修改此类对象并不会修改数据库的内容。
primaryKey有效键 执行将键转换为值 步骤的结果。注意，如果该属性返回对象（例如 Date 或 Array ），则每次检查它时都会返回相同的对象实例，直到游标的有效键 发生变化。这意味着如果对象被修改，任何检查游标值的人都会看到这些修改。然而，修改此类对象并不会修改数据库的内容。