IDBObjectStore.add

Sintaxis

var request = objectStore.add(myItem, optionalKey);

Retorno

Un objeto IDBRequest en el que los eventos subsecuentes relacionados a esta operación son lanzados.

Excepciones

Este método puede generar un DOMException con un DOMError de uno de los siguiente tipos:

Ejemplo

En el siguiente código, abrimos una transacción read/write en nuestra base de datos y agregado algunos datos al almacén de datos usando add(). También ten en cuenta que las funciones adjuntas a los manejadores de eventos de la transacción para informar en la salida de la apertura de transacciones en el evento de éxito o falla. Para un ejemplo completo funcionando, mira nuestra aplicación To-do Notifications (ver ejemplo).

// Abrimos nuestra base de datos
var DBOpenRequest = window.indexedDB.open("toDoList", 4);

DBOpenRequest.onsuccess = function(event) {
  note.innerHTML += '<li>Database initialised.</li>';
    
  // Almacenar el resultado de la apertura de la base de datos en la variable db. Esta es usada mucho después
  db = DBOpenRequest.result;
    
  // Ejecuta la función addData() para agregar los datos
  addData();
};

function addData() {
  // Crea un nuevo objeto listo para ser insertado en la IDB
  var newItem = [ { taskTitle: "Walk dog", hours: 19, minutes: 30, day: 24, month: "December", year: 2013, notified: "no" } ];

  // Inicia una transacción de lectura/escritura db transaction, lista para agregar los datos
  var transaction = db.transaction(["toDoList"], "readwrite");

  // Informa sobre el éxito de la inicio de la transacción
  transaction.oncomplete = function(event) {
    note.innerHTML += '<li>Transaction completed: database modification finished.</li>';
  };


  transaction.onerror = function(event) {
  note.innerHTML += '<li>Transaction not opened due to error. Duplicate items not allowed.</li>';
  };

  // Crea una almacén de objetos en la transacción
  var objectStore = transaction.objectStore("toDoList");

  // Agrega nuestro objeto newItem al almacén de objetos
  var objectStoreRequest = objectStore.add(newItem[0]);

  objectStoreRequest.onsuccess = function(event) {
    //Informa sobre el éxito de nuestro nuevo elemento en la base de datos
    note.innerHTML += '<li>New item added to database.</li>';
  };
};

Parámetros

value

El valor para ser almacenado.

key

La llave a usar para identificar el registro. Si no es especificada, el resultado es nulo.

Especificación

Compatibilidad de navegadores

Ver también

• Usando IndexedDB
• Iniciando transacciones: IDBDatabase
• Usando transacciones: IDBTransaction
• Estableciendo un rango de llaves: IDBKeyRange
• Obteniendo y haciendo cambios a tus datos: IDBObjectStore
• Usando cursores: IDBCursor
• Ejemplo de referencia: To-do Notifications (ver ejemplo.)