Almacenamiento para la Web

Existen muchas opciones diferentes para almacenar datos en el navegador. ¿Cuál es la mejor opción para tus necesidades?

Las conexiones a Internet pueden ser inestables o inexistentes cuando estás en movimiento, por lo que la compatibilidad sin conexión y el rendimiento confiable son funciones comunes en las apps web progresivas. Incluso en entornos inalámbricos perfectos, el uso prudente del almacenamiento en caché y otras técnicas de almacenamiento puede mejorar sustancialmente la experiencia del usuario. Existen varias formas de almacenar en caché los recursos estáticos de tu aplicación (HTML, JavaScript, CSS, imágenes, etc.) y los datos (datos del usuario, artículos de noticias, etc.). Pero ¿cuál es la mejor solución? ¿Cuánto puedes almacenar? ¿Cómo evitas que se desaloje?

¿Qué debería usar?

Esta es una recomendación general para almacenar recursos:

IndexedDB, el OPFS y la API de Cache Storage son compatibles con todos los navegadores actualizados. Son asíncronas y no bloquean el subproceso principal (pero también hay una variante síncrona del OPFS que está disponible exclusivamente en los trabajadores web). Se puede acceder a ellas desde el objeto window, los trabajadores web y los service workers, lo que permite usarlas en cualquier parte del código.

¿Qué ocurre con otros mecanismos de almacenamiento?

Existen varios otros mecanismos de almacenamiento disponibles en el navegador, pero tienen un uso limitado y pueden causar problemas de rendimiento significativos.

SessionStorage es específico de la pestaña y se limita a la duración de la pestaña. Puede ser útil para almacenar pequeñas cantidades de información específica de la sesión, por ejemplo, una clave de IndexedDB. Se debe usar con precaución, ya que es síncrono y bloqueará el subproceso principal. Tiene un límite de alrededor de 5 MB y solo puede contener cadenas. Debido a que es específico de la pestaña, no se puede acceder a él desde los trabajadores web ni los service workers.

Se debe evitar LocalStorage porque es síncrono y bloqueará el subproceso principal. Está limitado a unos 5 MB y solo puede contener cadenas. No se puede acceder a LocalStorage desde los trabajadores web ni los service workers.

Las cookies tienen sus usos, pero no se deben usar para el almacenamiento. Las cookies se envían con cada solicitud HTTP, por lo que almacenar más que una pequeña cantidad de datos aumentará significativamente el tamaño de cada solicitud web. Son síncronas y no se puede acceder a ellas desde los trabajadores web. Al igual que LocalStorage y SessionStorage, las cookies se limitan solo a cadenas.

La API de File System Access se diseñó para permitir que los usuarios lean y editen archivos en su sistema de archivos local. El usuario debe otorgar permiso antes de que una página pueda leer o escribir en cualquier archivo local, y los permisos no se conservan entre sesiones, a menos que se almacene en caché un controlador de archivos en IndexedDB. La API de acceso al sistema de archivos es más adecuada para casos de uso como editores, en los que necesitas abrir un archivo, modificarlo y, luego, guardar los cambios en el archivo.

La API de File System y la API de FileWriter proporcionan métodos para leer y escribir archivos en un sistema de archivos de zona de pruebas. Si bien es asíncrono, no se recomienda porque solo está disponible en navegadores basados en Chromium.

¿Cuánto puedo almacenar?

En resumen, mucho, al menos un par de cientos de megabytes y, posiblemente, cientos de gigabytes o más. Las implementaciones de los navegadores varían, pero la cantidad de almacenamiento disponible suele basarse en la cantidad de almacenamiento disponible en el dispositivo.

  • Chrome permite que el navegador use hasta el 80% del espacio total en el disco. Un origen puede usar hasta el 60% del espacio total en el disco. Puedes usar la API de StorageManager para determinar la cuota máxima disponible. Otros navegadores basados en Chromium pueden ser diferentes.
    • En el modo Incógnito, Chrome reduce la cantidad de almacenamiento que puede usar un origen a aproximadamente el 5% del espacio total en el disco.
    • Si el usuario habilitó la opción "Borrar cookies y datos de los sitios al cerrar todas las ventanas" en Chrome, la cuota de almacenamiento se reduce significativamente a un máximo de aproximadamente 300 MB.
  • Firefox permite que el navegador use hasta el 50% del espacio libre en el disco. Un grupo de eTLD+1 (p.ej., example.com, www.example.com y foo.bar.example.com) puede usar hasta 2 GB. Puedes usar la API de StorageManager para determinar cuánto espacio queda disponible.
  • Safari (tanto para computadoras de escritorio como para dispositivos móviles) parece permitir alrededor de 1 GB. Cuando se alcance el límite, Safari le indicará al usuario que aumente el límite en incrementos de 200 MB. No pude encontrar documentación oficial al respecto.
    • Si se agrega una AWP a la pantalla principal en Safari para dispositivos móviles, se crea un contenedor de almacenamiento nuevo y no se comparte nada entre la AWP y Safari para dispositivos móviles. Una vez que se alcanza la cuota de una AWP instalada, no parece haber ninguna forma de solicitar almacenamiento adicional.

En el pasado, si un sitio superaba un determinado umbral de datos almacenados, el navegador le solicitaba al usuario que otorgara permiso para usar más datos. Por ejemplo, si el origen usaba más de 50 MB, el navegador le pedía al usuario que le permitiera almacenar hasta 100 MB y, luego, volvía a preguntar en incrementos de 50 MB.

Hoy en día, la mayoría de los navegadores actualizados no le preguntarán al usuario y permitirán que un sitio use hasta la cuota asignada. La excepción parece ser Safari, que solicita permiso para aumentar la cuota de asignación cuando se supera la cuota de almacenamiento. Si un origen intenta usar más de la cuota asignada, los intentos posteriores de escribir datos fallarán.

¿Cómo puedo verificar cuánto almacenamiento tengo disponible?

En muchos navegadores, puedes usar la API de StorageManager para determinar la cantidad de almacenamiento disponible para el origen y cuánto almacenamiento está usando. Informa la cantidad total de bytes que usan IndexedDB y la API de Cache, y permite calcular el espacio de almacenamiento restante aproximado disponible.

if (navigator.storage && navigator.storage.estimate) {
  const quota = await navigator.storage.estimate();
  // quota.usage -> Number of bytes used.
  // quota.quota -> Maximum number of bytes available.
  const percentageUsed = (quota.usage / quota.quota) * 100;
  console.log(`You've used ${percentageUsed}% of the available storage.`);
  const remaining = quota.quota - quota.usage;
  console.log(`You can write up to ${remaining} more bytes.`);
}

Debes detectar los errores de exceso de cuota (consulta más abajo). En algunos casos, es posible que la cuota disponible supere la cantidad real de almacenamiento disponible.

Inspeccionar

Durante el desarrollo, puedes usar las Herramientas para desarrolladores de tu navegador para inspeccionar los diferentes tipos de almacenamiento y borrar todos los datos almacenados.

En Chrome 88, se agregó una nueva función que te permite anular la cuota de almacenamiento del sitio en el panel Almacenamiento. Esta función te permite simular diferentes dispositivos y probar el comportamiento de tus apps en situaciones de baja disponibilidad de disco. Ve a Aplicación y, luego, a Almacenamiento, habilita la casilla de verificación Simular cuota de almacenamiento personalizada y, luego, ingresa cualquier número válido para simular la cuota de almacenamiento.

¿Cómo se maneja el exceso de cuota?

¿Qué debes hacer cuando superas la cuota? Lo más importante es que siempre debes detectar y controlar los errores de escritura, ya sea un QuotaExceededError o cualquier otro. Luego, según el diseño de tu app, decide cómo controlarla. Por ejemplo, borra el contenido al que no se accedió durante mucho tiempo, quita los datos según el tamaño o proporciona una forma para que los usuarios elijan lo que quieren borrar.

Tanto IndexedDB como la API de Cache arrojan un DOMError llamado QuotaExceededError cuando superas la cuota disponible.

IndexedDB

Si el origen superó su cuota, los intentos de escribir en IndexedDB fallarán. Se llamará al controlador onabort() de la transacción y se pasará un evento. El evento incluirá un DOMException en la propiedad de error. Si se verifica el error name, se devolverá QuotaExceededError.

const transaction = idb.transaction(['entries'], 'readwrite');
transaction.onabort = function(event) {
  const error = event.target.error; // DOMException
  if (error.name == 'QuotaExceededError') {
    // Fallback code goes here
  }
};

API de Cache

Si el origen superó su cuota, los intentos de escribir en la API de Cache se rechazarán con un QuotaExceededError DOMException.

try {
  const cache = await caches.open('my-cache');
  await cache.add(new Request('/sample1.jpg'));
} catch (err) {
  if (error.name === 'QuotaExceededError') {
    // Fallback code goes here
  }
}

¿Cómo funciona el desalojo?

El almacenamiento web se clasifica en dos categorías: "Mejor esfuerzo" y "Persistente". El mejor esfuerzo significa que el navegador puede borrar el almacenamiento sin interrumpir al usuario, pero es menos duradero para los datos críticos o a largo plazo. El almacenamiento persistente no se borra automáticamente cuando el almacenamiento es bajo. El usuario debe borrar este almacenamiento de forma manual (a través de la configuración del navegador).

De forma predeterminada, los datos de un sitio (incluidos IndexedDB, la API de Cache, etcétera) se incluyen en la categoría de mejor esfuerzo, lo que significa que, a menos que un sitio haya solicitado almacenamiento persistente, el navegador puede expulsar los datos del sitio según su criterio, por ejemplo, cuando el almacenamiento del dispositivo es bajo.

La política de expulsión para el mejor esfuerzo es la siguiente:

  • Los navegadores basados en Chromium comenzarán a expulsar datos cuando el navegador se quede sin espacio, lo que borrará todos los datos del sitio del origen menos usado recientemente, luego el siguiente, hasta que el navegador ya no supere el límite.
  • Firefox comenzará a expulsar datos cuando se llene el espacio en el disco disponible, borrando todos los datos de sitios del origen menos usado recientemente primero, luego el siguiente, hasta que el navegador ya no supere el límite.
  • Anteriormente, Safari no expulsaba datos, pero hace poco implementó un nuevo límite de siete días para todo el almacenamiento de escritura (consulta más abajo).

A partir de iOS y iPadOS 13.4 y Safari 13.1 en macOS, hay un límite de siete días para todo el almacenamiento que se puede escribir con secuencias de comandos, incluidos IndexedDB, el registro de service workers y la API de Cache. Esto significa que Safari expulsará todo el contenido de la caché después de siete días de uso de Safari si el usuario no interactúa con el sitio. Esta política de expulsión no se aplica a las AWP instaladas que se agregaron a la pantalla principal. Consulta Full Third-Party Cookie Blocking and More en el blog de WebKit para obtener todos los detalles.

Buckets de almacenamiento

La idea principal de la API de Storage Buckets es otorgarles a los sitios la capacidad de crear varios buckets de almacenamiento, en los que el navegador puede elegir borrar cada bucket de forma independiente de los demás. Esto permite que los desarrolladores especifiquen la priorización de expulsión para asegurarse de que no se borren los datos más valiosos.

Bonus: Why use a wrapper for IndexedDB

IndexedDB es una API de bajo nivel que requiere una configuración significativa antes de su uso, lo que puede ser particularmente difícil para almacenar datos de baja complejidad. A diferencia de la mayoría de las APIs modernas basadas en promesas, esta se basa en eventos. Los wrappers de promesas, como idb para IndexedDB, ocultan algunas de las funciones potentes, pero, lo que es más importante, ocultan la maquinaria compleja (p.ej., transacciones, control de versiones de esquemas) que viene con la biblioteca de IndexedDB.

Bonus: SQLite Wasm

Después de que Web SQL dejó de estar disponible y se quitó de Chrome, Google trabajó con los encargados del mantenimiento de la popular base de datos SQLite para ofrecer un reemplazo de Web SQL basado en SQLite. Lee SQLite Wasm en el navegador respaldado por el sistema de archivos privado de origen para obtener detalles sobre cómo usarlo.

Conclusión

Ya no existen los días de almacenamiento limitado y de pedirle al usuario que almacene cada vez más datos. Los sitios pueden almacenar de manera eficaz todos los recursos y datos que necesitan para ejecutarse. Con la API de StorageManager, puedes determinar cuánto espacio tienes disponible y cuánto usaste. Y con el almacenamiento persistente, a menos que el usuario lo quite, puedes protegerlo de la expulsión.

Recursos adicionales

Gracias

Agradecemos especialmente a Jarryd Goodman, Phil Walton, Eiji Kitamura, Daniel Murphy, Darwin Huang, Josh Bell, Marijn Kruisselbrink y Victor Costan por revisar esta guía. Agradecemos a Eiji Kitamura, Addy Osmani y Marc Cohen, quienes escribieron los artículos originales en los que se basa este contenido. Eiji escribió una herramienta útil llamada Browser Storage Abuser que fue útil para validar el comportamiento actual. Te permite almacenar la mayor cantidad de datos posible y ver los límites de almacenamiento en tu navegador. Agradecemos a François Beaufort, quien investigó Safari para descubrir sus límites de almacenamiento, y a Thomas Steiner, quien agregó información sobre el sistema de archivos privado de origen, los buckets de almacenamiento y SQLite Wasm, y una actualización general del contenido en 2024.