IDBIndex (GWT Elemental 2.7.0)

All Known Implementing Classes:

JsIDBIndex
```
public interface IDBIndex
```
The IDBIndex interface of the IndexedDB API provides asynchronous access to an index in a database. An index is a kind of object store for looking up records in another object store, called the referenced object store. You use this interface to retrieve data.

Inherits from: EventTarget

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`IDBRequest`	`count()` Returns an IDBRequest object, and in a separate thread, returns the number of records within a key range.
`IDBRequest`	`count(IDBKeyRange range)` Returns an IDBRequest object, and in a separate thread, returns the number of records within a key range.
`IDBRequest`	`count(Object key)` Returns an IDBRequest object, and in a separate thread, returns the number of records within a key range.
`IDBRequest`	`get(IDBKeyRange key)` Returns an IDBRequest object, and, in a separate thread, finds either:
`IDBRequest`	`getKey(IDBKeyRange key)` Returns an IDBRequest object, and, in a separate thread, finds either:
`IDBRequest`	`getKey(Object key)` Returns an IDBRequest object, and, in a separate thread, finds either:
`Object`	`getKeyPath()`
`String`	`getName()`
`IDBRequest`	`getObject(Object key)`
`IDBObjectStore`	`getObjectStore()`
`boolean`	`isMultiEntry()`
`boolean`	`isUnique()`
`IDBRequest`	`openCursor()` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range.
`IDBRequest`	`openCursor(IDBKeyRange range)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range.
`IDBRequest`	`openCursor(IDBKeyRange range, int direction)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range.
`IDBRequest`	`openCursor(IDBKeyRange range, String direction)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range.
`IDBRequest`	`openCursor(Object key)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range.
`IDBRequest`	`openCursor(Object key, int direction)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range.
`IDBRequest`	`openCursor(Object key, String direction)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range.
`IDBRequest`	`openKeyCursor()` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range, as arranged by this index.
`IDBRequest`	`openKeyCursor(IDBKeyRange range)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range, as arranged by this index.
`IDBRequest`	`openKeyCursor(IDBKeyRange range, int direction)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range, as arranged by this index.
`IDBRequest`	`openKeyCursor(IDBKeyRange range, String direction)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range, as arranged by this index.
`IDBRequest`	`openKeyCursor(Object key)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range, as arranged by this index.
`IDBRequest`	`openKeyCursor(Object key, int direction)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range, as arranged by this index.
`IDBRequest`	`openKeyCursor(Object key, String direction)` Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range, as arranged by this index.

Method Detail

getKeyPath
```
Object getKeyPath()
```

isMultiEntry
```
boolean isMultiEntry()
```

getName
```
String getName()
```

getObjectStore
```
IDBObjectStore getObjectStore()
```

isUnique
```
boolean isUnique()
```

count
```
IDBRequest count()
```
Returns an IDBRequest object, and in a separate thread, returns the number of records within a key range. For example, if you want to see how many records are between keys 1000 and 2000 in an object store, you can write the following: var req = store.count(IDBKeyRange.bound(1000, 2000));
```
IDBRequest count (
  in optional any key
) raises (IDBDatabaseException);
```
Parameters

key

The key or key range that identifies the record to be counted.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise a IDBDatabaseException with the following code:

Attribute Description

DATA_ERR The key parameter was not a valid value.

NOT_ALLOWED_ERR The request was made on a source object that has been deleted or removed.

Attribute	Description
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

count
```
IDBRequest count(IDBKeyRange range)
```
Returns an IDBRequest object, and in a separate thread, returns the number of records within a key range. For example, if you want to see how many records are between keys 1000 and 2000 in an object store, you can write the following: var req = store.count(IDBKeyRange.bound(1000, 2000));
```
IDBRequest count (
  in optional any key
) raises (IDBDatabaseException);
```
Parameters

key

The key or key range that identifies the record to be counted.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise a IDBDatabaseException with the following code:

Attribute Description

DATA_ERR The key parameter was not a valid value.

NOT_ALLOWED_ERR The request was made on a source object that has been deleted or removed.

Attribute	Description
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

count
```
IDBRequest count(Object key)
```
Returns an IDBRequest object, and in a separate thread, returns the number of records within a key range. For example, if you want to see how many records are between keys 1000 and 2000 in an object store, you can write the following: var req = store.count(IDBKeyRange.bound(1000, 2000));
```
IDBRequest count (
  in optional any key
) raises (IDBDatabaseException);
```
Parameters

key

The key or key range that identifies the record to be counted.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise a IDBDatabaseException with the following code:

Attribute Description

DATA_ERR The key parameter was not a valid value.

NOT_ALLOWED_ERR The request was made on a source object that has been deleted or removed.

Attribute	Description
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

get

IDBRequest get(IDBKeyRange key)

Returns an IDBRequest object, and, in a separate thread, finds either:

The value in the referenced object store that corresponds to the given key.
The first corresponding value, if key is a key range.

If a value is successfully found, then a structured clone of it is created and set as the result of the request object.

Note: This method produces the same result for: a) a record that doesn't exist in the database and b) a record that has an undefined value. To tell these situations apart, call the openCursor() method with the same key. That method provides a cursor if the record exists, and not if it does not.

IDBRequest get (
  in any key
) raises (IDBDatabaseException);

Parameters

key: The key or key range that identifies the record to be retrieved.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

getObject
```
IDBRequest getObject(Object key)
```

getKey

IDBRequest getKey(IDBKeyRange key)

Returns an IDBRequest object, and, in a separate thread, finds either:

The value in the index that corresponds to the given key
The first corresponding value, if key is a key range.

If a value is successfully found, then a structured clone of it is created and set as the result of the request object.

IDBRequest getKey (
  in any key
) raises (IDBDatabaseException);

Parameters

key: The key or key range that identifies the record to be retrieved.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise a IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

getKey

IDBRequest getKey(Object key)

Returns an IDBRequest object, and, in a separate thread, finds either:

The value in the index that corresponds to the given key
The first corresponding value, if key is a key range.

If a value is successfully found, then a structured clone of it is created and set as the result of the request object.

IDBRequest getKey (
  in any key
) raises (IDBDatabaseException);

Parameters

key: The key or key range that identifies the record to be retrieved.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise a IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openCursor

IDBRequest openCursor()

Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range. The method sets the position of the cursor to the appropriate record, based on the specified direction.

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to a structured clone of the referenced value.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openCursor

IDBRequest openCursor(IDBKeyRange range)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to a structured clone of the referenced value.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openCursor

IDBRequest openCursor(IDBKeyRange range,
                      String direction)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to a structured clone of the referenced value.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openCursor

IDBRequest openCursor(Object key)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to a structured clone of the referenced value.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openCursor

IDBRequest openCursor(Object key,
                      String direction)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to a structured clone of the referenced value.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openCursor

IDBRequest openCursor(IDBKeyRange range,
                      int direction)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to a structured clone of the referenced value.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openCursor

IDBRequest openCursor(Object key,
                      int direction)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to a structured clone of the referenced value.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openKeyCursor

IDBRequest openKeyCursor()

Returns an IDBRequest object, and, in a separate thread, creates a cursor over the specified key range, as arranged by this index. The method sets the position of the cursor to the appropriate record, based on the specified direction.

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to the value of the found record.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openKeyCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openKeyCursor

IDBRequest openKeyCursor(IDBKeyRange range)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to the value of the found record.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openKeyCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openKeyCursor

IDBRequest openKeyCursor(IDBKeyRange range,
                         String direction)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to the value of the found record.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openKeyCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openKeyCursor

IDBRequest openKeyCursor(Object key)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to the value of the found record.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openKeyCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openKeyCursor

IDBRequest openKeyCursor(Object key,
                         String direction)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to the value of the found record.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openKeyCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openKeyCursor

IDBRequest openKeyCursor(IDBKeyRange range,
                         int direction)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to the value of the found record.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openKeyCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

openKeyCursor

IDBRequest openKeyCursor(Object key,
                         int direction)

If the key range is not specified or is null, then the range includes all the records.
If at least one record matches the key range, then a success event is fired on the result object, with its result set to the new IDBCursor object; the value of the cursor object is set to the value of the found record.
If no records match the key range, then then an error event is fired on the request object, with its code set to NOT_FOUND_ERR and a suitable message.

IDBRequest openKeyCursor (
  in optional any? range, 
  in optional unsigned short direction
) raises (IDBDatabaseException);

Parameters

range: Optional. The key range to use as the cursor's range.
direction: Optional. The cursor's required direction. See IDBCursor Constants for possible values.

Returns

IDBRequest

A request object on which subsequent events related to this operation are fired.

Exceptions

This method can raise an IDBDatabaseException with the following code:

Attribute	Description
`TRANSACTION_INACTIVE_ERR`	The index's transaction is not active.
`DATA_ERR`	The `key` parameter was not a valid value.
`NOT_ALLOWED_ERR`	The request was made on a source object that has been deleted or removed.

Interface IDBIndex

Method Summary

Method Detail

getKeyPath

isMultiEntry

getName

getObjectStore

isUnique

count

Parameters

Returns

Exceptions

count

Parameters

Returns

Exceptions

count

Parameters

Returns

Exceptions

get

Parameters

Returns

Exceptions

getObject

getKey

Parameters

Returns

Exceptions

getKey

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openCursor

Parameters

Returns

Exceptions

openKeyCursor

Parameters

Returns

Exceptions

openKeyCursor

Parameters

Returns

Exceptions

openKeyCursor

Parameters

Returns

Exceptions

openKeyCursor

Parameters

Returns

Exceptions

openKeyCursor

Parameters

Returns