W3cubDocs

/Web APIs

IDBCursorSync

Draft: This page is not complete.

Warning: The synchronous version of the IndexedDB API was originally intended for use only with Web Workers, and was eventually removed from the spec because its need was questionable. It may however be reintroduced in the future if there is enough demand from web developers.

The IDBCursorSync interface of the IndexedDB API represents a cursor for iterating over multiple records in a database. You can have only one instance of IDBCursorSync representing a cursor, but you can have an unlimited number of cursors at the same time. Operations are performed on the underlying index or object store. It enables an application to synchronously process all the records in the cursor's range.

Method overview

bool continue (in optional any key);
void remove () raises (IDBDatabaseException);

Attributes

Attribute Type Description
count readonly unsigned long long The total number of objects that share the current key.
direction readonly unsigned short The direction of traversal of the cursor. See Constants for possible values.
key readonly any The key for the record at the cursor's position.
value any

The value for the record at the cursor's position. Setting this attribute can raise an IDBDatabaseException with the following codes:

DATA_ERR
If the underlying object store uses in-line keys and the property at the key path does not match the key in this cursor's position.
NOT_ALLOWED_ERR
If the underlying index or object store does not support updating the record because it is open in the READ_ONLY or SNAPSHOT_READ mode, or if an index record cannot be changed because the underlying index is auto-populated.
SERIAL_ERR
If the data being stored could not be serialized by the internal structured cloning algorithm.

Constants

Constant Value Description
NEXT 0 This cursor includes duplicates, and its direction is monotonically increasing in the order of keys.
NEXT_NO_DUPLICATE 1 This cursor does not include duplicates, and its direction is monotonically increasing in the order of keys.
PREV 2 This cursor includes duplicates, and its direction is monotonically decreasing in the order of keys.
PREV_NO_DUPLICATE 3 This cursor does not include duplicates, and its direction is monotonically decreasing in the order of keys.

Methods

continue()

Advances the cursor to the next position along its direction, to the item whose key matches the optional key parameter. If no key is specified, advance to the immediate next position. Returns false if the cursor has reached the end of its range; otherwise returns true.

bool continue (
  in optional any key
);
Parameters
key

The key to which to move the cursor's position.

remove()

Deletes the record at the cursor's position, without changing the cursor's position

void delete (
) raises (DatabaseException);
Exceptions

This method can raise an IDBDatabaseException with the following code:

NOT_ALLOWED_ERR

If the underlying index or object store does not support updating the record because it is open in the READ_ONLY or SNAPSHOT_READ mode.

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IDBCursorSync