Storage.setItem()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

El método setItem() de la interfaz Storage, cuando reciba una clave y un valor, añadirá estos al almacén, o actualizará el valor si la clave ya existe.

Sintaxis

storage.setItem(keyName, keyValue);

Parámetros

keyName: Un DOMString conteniendo la clave que se quiere crear/actualizar.
keyValue: Un DOMString conteniendo el valor que se le quiere dar a la clave que se está creando/actualizando.

setItem() puede lanzar una excepción si el almacén esta lleno. Particularmente, en Safari Mobile (desde iOS 5) siempre lo hará cuando el usuario ingresa en modo privado (Safari determina una cuota de 0 bytes en modo privado, al contrario de otros navegadores, que permiten almacenamiento en modo privado, usando contenedores de información separados). Por lo tanto, los desarrolladores deben asegurarse de capturar siempre las posibles excepciones de setItem().

Ejemplo

La siguiente función crea tres ítems dentro del almacenamiento local.

function populateStorage() {
  localStorage.setItem("bgcolor", "red");
  localStorage.setItem("font", "Helvetica");
  localStorage.setItem("image", "myCat.png");
}

Nota: Para ver un ejemplo real, vea nuestro Web Storage Demo.

Especificaciones

Specification
HTML Standard # dom-storage-setitem-dev

Compatibilidad con navegadores

BCD tables only load in the browser

Vea también

Usando la Web Storage API