我常常想，如果网络应用能够读取和写入文件与目录，将会非常方便。从离线转移到在线后，应用变得更加复杂，而文件系统方面的API的缺乏也一直阻碍着网络前进。存储二进制数据或与其进行交互不应局限于桌面。令人欣慰的是，由于FileSystemAPI的出现，这一现状终于得到了改变。有了FileSystemAPI，网络应用就可以创建、读取、导航用户本地文件系统中的沙盒部分以及向其中写入数据。

API 被分为以下不同的主题：

读取和处理文件：File/Blob、FileList、FileReader

创建和写入：BlobBuilder、FileWriter

目录和文件系统访问：DirectoryReader、FileEntry/DirectoryEntry、LocalFileSystem

浏览器支持与存储限制

在写这篇文章时，只有 GoogleChrome 浏览器可以实施此FileSystemAPI。目前尚不存在专门用于文件/配额管理的浏览器用户界面。要在用户的系统上存储数据，您的应用可能需要。不过，可使用--unlimited-quota-for-files标记运行Chrome浏览器进行测试。此外，如果您要开发的是用于Chrome网上应用店的应用或扩展程序，可使用unlimitedStorage清单文件权限，而无需请求配额。最后，用户会收到授予、拒绝或为应用增加存储的权限对话框。

如果您要通过 file://调试您的应用，可能需要--allow-file-access-from-files标记。不使用这些标记会导致SECURITY_ERR或QUOTA_EXCEEDED_ERRFileError。

请求文件系统

网络应用可通过调用 window.requestFileSystem()请求对沙盒文件系统的访问权限：

// Note: The file system has been prefixed as of Google Chrome 12:  

window.requestFileSystem  = window.requestFileSystem || window.webkitRequestFileSystem;  

  

window.requestFileSystem(type, size, successCallback, opt_errorCallback)  

type   文件存储是否应该是持久的。可能的值包括window.TEMPORARY和window.PERSISTENT。通过TEMPORARY存储的数据可由浏览器自行决定删除（例如在需要更多空间的情况下）。要清除PERSISTENT存储，必须获得用户或应用的明确授权，并且需要用户向您的应用授予配额。请参阅。   size   应用需要用于存储的大小（以字节为单位）。   successCallback   文件系统请求成功时调用的回调。其参数为 对象。   opt_errorCallback   用于处理错误或获取文件系统的请求遭到拒绝时可选的回调。其参数为对象。  

如果您是首次调用requestFileSystem()，系统会为您的应用创建新的存储。请注意，这是沙箱文件系统，也就是说，一个网络应用无法访问另一个应用的文件。这也意味着您无法在用户硬盘上的任意文件夹（例如“我的图片”、“我的文档”等）中读/写文件。

用法示例：

function onInitFs(fs) { console.log(‘Opened file system: ‘ + fs.name); } window.requestFileSystem(window.TEMPORARY, 5*1024*1024 /*5MB*/, onInitFs, errorHandler);

FileSystem 规范还定义了计划用于的同步API()接口。不过，本教程不涉及该同步API。

在本文档的其余部分中，我们将使用相同的处理程序处理异步调用引发的错误：

function errorHandler(e) {  

  var msg = ‘‘;  

  

  switch (e.code) {  

    case FileError.QUOTA_EXCEEDED_ERR:  

      msg = ‘QUOTA_EXCEEDED_ERR‘;  

      break;  

    case FileError.NOT_FOUND_ERR:  

      msg = ‘NOT_FOUND_ERR‘;  

      break;  

    case FileError.SECURITY_ERR:  

      msg = ‘SECURITY_ERR‘;  

      break;  

    case FileError.INVALID_MODIFICATION_ERR:  

      msg = ‘INVALID_MODIFICATION_ERR‘;  

      break;  

    case FileError.INVALID_STATE_ERR:  

      msg = ‘INVALID_STATE_ERR‘;  

      break;  

    default:  

      msg = ‘Unknown Error‘;  

      break;  

  };  

  

  console.log(‘Error: ‘ + msg);