文件系统API的基本概念编辑

文件系统API（File System API）模拟网络应用程序可以导航到的本地文件系统。你可以开发应用在一个沙盒的虚拟文件系统中读、写、创建以及索引文件。

该文件系统API与其他相关的API交互。它基于文件写入API（File Writer API），而后者又基于文件API（File API）。每一个API都具有不同的功能。这些API对于网络应用而言是一个巨大的进化飞跃，使得它们能够缓存和处理大量级的数据。

关于这篇文档

这篇介绍讨论了文件系统API中的基本概念和术语。它将给出一个大致的蓝图并引导你理解其中的关键概念. 它也描述了一些限制，如果你忽略了它们将额能产生安全错误。关于该API中使用的更多术语，查看定义部分.

关于文件系统API的引用文献部分，查看引用的登陆页及其子页.

该规范仍然在定义中并可能会变更.

文件系统API包括异步和同步两种接口。异步API可以应用于当你不想操作锁定UI的情况。另一方面，同步API允许简单的程序模型，但它必须和WebWorkers一起使用.

文件系统API的重要性体现在以下方面：

关于你用该api能够创建的特性示例，查看使用示例部分.

文件系统API是一些其他存储API，例如 IndexedDB, WebSQL(已于2010年9月18日起弃用)，以及AppCache等的替代品。该API对于那些处理blob的应用而言是一种更好的选择，因为：

文件系统API提供客户端存储以应对不在数据库中存储的应用场景。如果你需要大型可变的数据块，比数据库而言它就是一种更有效率的存储解决方案。
尽管Firefox支持IndexedDB的blob存储，但是目前Chrome并非如此（Chrome仍然在对IndexedDB的blob存储做实现支持开发中）。如果你的应用面向Chrome并且你需要存储blobs, 那么文件系统API和App Cache将是你唯一的选择。然而，AppCache存储并不是本地可变的，并且不支持细粒度的客户端管理。
在Chrome中，你可以使用文件系统API和配额管理API Quota Management API, 后者允许你请求更多的存储以及管理你的存储配额。

下面是关于你可以如何使用文件系统API的几个示例：

有上传器的应用
- 当你选择一个文件或目录进行上传时，你可以赋值文件到一个本地沙盒并一次上传一个块。
- 应用可以在一次中断后重新上传，中断可能包括浏览器被关闭或崩溃，连接中断，或电脑被关闭。
视频游戏或其他使用大量媒体资源的应用
- 应用下载一个或多个大压缩包并在本地将他们解压到一个文件目录中。
- 应用能在后台预取资源，从而让用户能够进入下一项工作或游戏等级，而不需要等待下载。
音频或照片编辑器使用线下访问或本地缓存（有助于表现和速度）
- 应用可以分段写入文件（例如只覆盖ID3/EXIF标签而不是整个文件）。
线下视频浏览
- 应用可以下载大文件（>1GB）用于以后浏览。
- 应用可以访问只下载了部分的文件（因此你可以查看你的DVD的第一章，即使应用仍在下载剩余部分，或者当你需要取赶火车而没有完成下载时）。
线下网络邮件客户端
- 客户端下载附件并在本地存储它们。
- 客户端缓存附件用于稍后的上传。

在开始使用文件系统API之前，你需要理解几个概念：

WebWorkers. 异步的API可以在文档或WebWorkers 上下文中使用, 而同步API只能用于WebWorkers.
Callbacks. 异步API不会将数据作为返回值；作为替代，你需要传递一个回调函数。你在操作中发送请求，并在回调时得到通知。相反，同步API不使用回调函数，因为API方法返回值。
异步和同步API的全局方法. 异步API拥有这些全局方法：requestFileSystem() 和 resolveLocalFileSystemURL(). 这些方法同时是window对象和worker全局作用域的成员。另一方面，同步API使用如下方法：requestFileSystemSync() 和 resolveLocalFileSystemSyncURL(). 这些同步方法只是worker全局作用域的成员，而非window对象的。

对于一些任务而言同步API可能更简单一些。它直接的，顺序编程的模块可以让代码更易于阅读。其缺点在于它必须与Web Worker交互，而后者有一些限制。

当使用异步API时，务必总是使用错误回调。虽然对于相关的方法而言错误回调是可选参数，但是明智的做法是把它们当成必选的。至少，通过处理错误得到的错误信息，你可以知道发生了什么。

文件系统API被设计用于在网络平台上与其他API以及元素交互。例如，你可能使用到如下内容之一：

文件系统API区分大小写并保留大小写。

出于安全的原因，浏览器对于文件的访问施加了一些限制。如果你忽略它们，将会产生安全错误。

blob: 代表二进制大对象。一个blob是存储在单一对象中的一组二进制数据。这是在网络应用中引用二进制数据的通用方法。一个blob可以是一个图片或音频文件。
Blob: Blob（以大写B开头的）是一个不可变的数据结构，这意味着一个blob引用的二进制数据不能被直接修改。这使得当Blobs传入到异步API时它们的行为将是可预见的。
persistent storage | 固定存储: 固定存储是一种在浏览器中长期存在的的存储，除非用户永久删除它或应用删除它。
temporary storage | 临时存储: 临时存储是任何网络应用都拥有的。它是自动而不需要请求的，但浏览器可以没有任何警告地删除这些存储。