1358701 - IDBObjectStore.put should mention that you have to supply the primary key in the second argument if you want to modify a record and your object store uses an autoIncrement key

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: API: IndexedDB, enhancement, P5)

Description

[Markus Stange [:mstange]]

:: Developer Documentation Request

      Request Type: Correction
     Gecko Version: unspecified
 Technical Contact: 

:: Details

For object stores that have an autoIncrement primary key, the key is not in a field on the record object. So calling put(record) will always insert a new record, because it doesn't know what existing record you might want to modify. So you if you really want to modify an existing record, you'll need to call put(record, cursor.primaryKey) (or get the primaryKey from somewhere else).

The documentation should spell this out.

Comment 1

[Chris Mills [:cmills]]

Gah, this page is badly written ;-)

To improve things, I've updated the summary (first paragraph of the page) to say more clearly what the method actually does, and added a parameters section that explains what you cited as missing in this bug:

https://developer.mozilla.org/en-US/docs/Web/API/IDBObjectStore/put#Parameters

Let me know if you think this is better now.