This IndexedDB API interface represents a cursor for traversing or iterating over multiple records in a database. It is the same as the IDBCursor, except that it includes the value property.

interface IDBCursorWithValue {
    direction: IDBCursorDirection;
    key: IDBValidKey;
    primaryKey: IDBValidKey;
    request: IDBRequest<any>;
    source: IDBObjectStore | IDBIndex;
    value: any;
    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.

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

primaryKey: IDBValidKey

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

request: IDBRequest<any>
source: IDBObjectStore | IDBIndex

Returns the IDBObjectStore or IDBIndex the cursor was opened from.

value: any

Returns the cursor's current value.

Methods

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

    Parameters

    • count: number

    Returns void

  • Advances the cursor to the next record in range.

    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.

    Parameters

    Returns void

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

    If successful, request's result will be undefined.

    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.

    Parameters

    • value: any

    Returns IDBRequest<IDBValidKey>