Using The HTML5 Filesystem API

Guía breve de O'Reilly escrita en 2011 por Eric Bidelman, ingeniero de relaciones con desarrolladores del equipo de Google Chrome, sobre la API FileSystem de HTML5 (File API: Directories and System). Esta API daba a las aplicaciones web un sistema de archivos y carpetas propio, en una zona aislada (sandbox) del disco del usuario. Está dirigida a desarrolladores web de nivel intermedio que ya dominan JavaScript, las callbacks asíncronas y, de forma básica, la File API y los Blobs.

El libro presenta los casos de uso, las consideraciones de seguridad y el soporte de los navegadores. Luego explica los tipos de almacenamiento (temporal, persistente e ilimitado) y la Quota Management API para pedir más espacio y consultar el uso. Después enseña a abrir el sistema de archivos con requestFileSystem, a manejar errores y a trabajar con FileEntry y DirectoryEntry: crear, leer, escribir y añadir datos con FileWriter, listar y borrar directorios (también de forma recursiva), y copiar, mover y renombrar entradas. Muestra cuatro formas de importar archivos del usuario: input type=file, arrastrar y soltar, XMLHttpRequest2 con respuestas binarias, y copiar y pegar. También compara las URLs filesystem:, blob: y data:. Cierra con la versión síncrona de la API dentro de Web Workers.

Está organizado como una serie de fragmentos de código cortos y listos para reutilizar. Los ejemplos finales recorren todas las entradas del sistema de archivos y descargan archivos con XHR2 desde un Worker. No hay un proyecto completo. Conviene saber que esta API solo se implementó en navegadores basados en Chrome, que el W3C la abandonó y que hoy está obsoleta. Para necesidades parecidas se usan IndexedDB, la File System Access API y el Origin Private File System (OPFS), aunque los conceptos de cuotas y archivos en sandbox que explica siguen siendo útiles.