Window: requestFileSystem() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

非标准 Window 方法 requestFileSystem() 是一个 Google Chrome 特有的方法,允许网站或应用程序访问一个沙盒文件系统供其自身使用。返回的 FileSystem 对象随后可用于其他 文件系统 API

注意:在所有实现此方法的浏览器中,此方法都带有 webkit 前缀。

语法

js
requestFileSystem(type, size, successCallback)
requestFileSystem(type, size, successCallback, errorCallback)

参数

type

要请求的存储类型。如果浏览器可以酌情删除文件(例如存储空间不足时),请指定 Window.TEMPORARY;如果您需要文件保持不变,除非用户或网站或应用程序明确允许,请指定 Window.PERSISTENT。持久化存储需要用户授予站点配额。

size

您希望为您的应用程序分配的存储空间大小。

successCallback

当文件系统成功获取时调用的函数。回调函数接收一个参数:一个 FileSystem 对象,表示应用程序有权限使用的文件系统。

errorCallback 可选

一个可选参数,指定一个函数,在尝试获取文件系统时发生错误,或者用户拒绝创建或访问文件系统的权限时调用。回调函数接收一个参数作为输入:一个描述错误的 DOMException 对象。

返回值

无(undefined)。

规范

由于此方法已从 文件和目录条目 API 提案中移除,因此它没有官方的 W3C 或 WHATWG 规范。它不再有望成为标准。

浏览器兼容性