storage.local

Representa el área de almacenamiento local. Los elementos en el almacenamiento local son locales a la máquina en la que se instaló la extensión.

El navegador puede restringir la cantidad de datos que una extensión puede almacenar en el área de almacenamiento local:

Chrome limita la extensión a 5MB de datos usando esta API a menos que tenga el permiso "unlimitedStorage". Firefox le permite solicitar el permiso "Almacenamiento ilimitado" de la versión 56 en adelante. Aún no restringe la cantidad de datos que su extensión puede almacenar, pero comenzará a hacerlo en una versión futura: por lo tanto, es una buena idea solicitar el permiso de "Almacenamiento ilimitado" ahora, si tiene la intención de almacenar una gran cantidad de datos.

Cuando se desinstala la extensión, se borra su almacenamiento local asociado.

También en Firefox, puede evitar que el navegador borre el almacenamiento local al desinstalar "about: config" y configurar las siguientes dos preferencias de navegador como verdaderas: "keepUuidOnUninstall" y "keepStorageOnUninstall". Esta característica se proporciona para ayudar a los desarrolladores a probar sus extensiones. Las extensiones en sí mismas no pueden cambiar estas preferencias.

Aunque esta API es similar a Window.localStorage, se recomienda que no use Window.localStorage en el código de extensión. Firefox borrará los datos almacenados por las extensiones utilizando la API localStorage en varios escenarios donde los usuarios borran su historial de navegación y los datos por razones de privacidad, mientras que los datos guardados utilizando la API storage.local se conservarán correctamente en estos escenarios.

Metodos

El objeto local implementa los métodos definidos en elstorage.StorageArea tipo:

storage.StorageArea.get()

Recupera uno o más elementos del área de almacenamiento.

storage.StorageArea.getBytesInUse()

Obtiene la cantidad de espacio de almacenamiento (en bytes) utilizado por uno o más elementos que se almacenan en el área de almacenamiento.

storage.StorageArea.set()

Almacena uno o más artículos en el área de almacenamiento. Si el artículo ya existe, su valor será actualizado. Cuando establezca un valor, se activará el evento storage.onChanged.

storage.StorageArea.remove()

Elimina uno o más elementos del área de almacenamiento.

storage.StorageArea.clear()

Elimina todos los elementos del área de almacenamiento.

Compatibilidad con navegadores

BCD tables only load in the browser

Example extensions

Nota: Agradecimientos

Esta API se basa en la API chrome.storage de Chromium. Esta documentación se deriva de storage.json en el código de Chromium.

Los datos de compatibilidad de Microsoft Edge son proporcionados por Microsoft Corporation y se incluyen aquí bajo la Licencia de Estados Unidos Creative Commons Attribution 3.0.