Interface IDBCursor

This IndexedDB API interface represents a cursor for traversing or iterating over multiple records in a database.

MDN Reference

interface IDBCursor {
    direction: IDBCursorDirection;
    key: IDBValidKey;
    primaryKey: IDBValidKey;
    request: IDBRequest<any>;
    source: IDBObjectStore | IDBIndex;
    advance(count: number): void;
    continue(key?: IDBValidKey): void;
    continuePrimaryKey(key: IDBValidKey, primaryKey: IDBValidKey): void;
    delete(): IDBRequest<undefined>;
    update(value: any): IDBRequest<IDBValidKey>;
}

Hierarchy (view full)

Properties

Returns the direction ("next", "nextunique", "prev" or "prevunique") of the cursor.

MDN Reference

Returns the key of the cursor. Throws a "InvalidStateError" DOMException if the cursor is advancing or is finished.

MDN Reference

primaryKey: IDBValidKey

Returns the effective key of the cursor. Throws a "InvalidStateError" DOMException if the cursor is advancing or is finished.

MDN Reference

request: IDBRequest<any>
source: IDBObjectStore | IDBIndex

Returns the IDBObjectStore or IDBIndex the cursor was opened from.

MDN Reference

Methods

  • Advances the cursor through the next count records in range.

    MDN Reference

    Parameters

    • count: number

    Returns void

  • Advances the cursor to the next record in range.

    MDN Reference

    Parameters

    Returns void

  • Advances the cursor to the next record in range matching or after key and primaryKey. Throws an "InvalidAccessError" DOMException if the source is not an index.

    MDN Reference

    Parameters

    Returns void

  • Delete the record pointed at by the cursor with a new value.

    If successful, request's result will be undefined.

    MDN Reference

    Returns IDBRequest<undefined>

  • Updated the record pointed at by the cursor with a new value.

    Throws a "DataError" DOMException if the effective object store uses in-line keys and the key would have changed.

    If successful, request's result will be the record's key.

    MDN Reference

    Parameters

    • value: any

    Returns IDBRequest<IDBValidKey>