LocalFileSystemSync

在此页

关于本文档
基本概念
方法概述
常量
方法
浏览器兼容性
另请参阅
相关话题

非标
此特征是非标准的，且不在标准轨道中。不要在面向 Web 的生产站点中使用它：它不适用于每个用户。实现之间可能存在大的不兼容性，且行为将来可能改变。

LocalFileSystemSync 接口在文件系统 API gives you access to a sandboxed file system. It is intended to be used with WebWorkers . The methods are implemented by worker 对象。

关于本文档

This document was last updated on March 2, 2012 and follows the W3C Specifications (Working Draft) drafted on April 19, 2011.

This specification is more or less abandonned, failing to get significant traction.

基本概念

You can request access to a sandboxed file system by requesting LocalFileSystemSync object from within a web worker. The global methods in the window 对象 requestFileSystemSync() and resolveLocalFileSystemSyncURL() methods are exposed to the Worker's global scope. Calling window.requestFileSystemSync() for creates new storage for your web app.

For more concepts, see the counterpart article for the asynchronous API .

范例

//Taking care of the browser-specific prefix
window.requestFileSystemSync  = window.requestFileSystemSync || window.webkitRequestFileSystemSync;
// The first parameter defines the type of storage: persistent or temporary
// Next, set the size of space needed (in bytes)
// initFs is the success callback
// And the last one is the error callback
// for denial of access and other errors.
var fs = requestFileSystemSync(TEMPORARY, 1024*1024 /*1MB*/);

Because you are using a synchronous API, you don't need success and error callbacks.

方法概述


										FileSystemSync
										
											requestFileSystemSync
										
										(in unsigned short
										
											type
										
										, in long long
										
											size
										
										) raises
										
											FileException
										
										;


										EntrySync
										
											resolveLocalFileSystemSyncURL
										
										(in DOMString
										
											url
										
										) raises
										
											FileException
										
										;

常量

常量	值	描述
`TEMPORARY`	`0`	Transient storage that can be be removed by the browser at its discretion.
`PERSISTENT`	`1`	Storage that stays in the browser unless the user or the app expunges it.

方法

requestFileSystemSync()

Requests a file system where data should be stored. You access a sandboxed file system by requesting a LocalFileSystemSync object from within a web worker using this global method, window.requestFileSystemSync() . [ RESEARCH ]

FileSystemSync requestFileSystemSync(
  in unsigned short type,
  in unsigned long long size
);

参数

type: The storage type of the file system. The values can be either TEMPORARY or PERSISTENT .
size

FileSystemSync

异常

This method can raise an FileException 通过以下代码：

异常	描述
`SECURITY_ERROR`	The application does not have permission to access the file system interface. For example, you cannot run from `file://` . For more details, see the article on basic concepts .

resolveLocalFileSystemSyncURL()

Allows the user to look up the Entry for a file or directory referred to by a local URL.

void resolveLocalFileSystemURL(
  in DOMString url
);

参数

url

EntrySync

异常

This method can raise a FileException with the following codes:

异常	描述
`ENCODING_ERR`	The syntax of the URL was invalid.
`NOT_FOUND_ERR`	The URL was structurally correct, but refers to a resource that does not exist.
`SECURITY_ERR`	The application does not have permission to access the file system interface.

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

No compatibility data found. Please contribute data for "api.LocalFileSystemSync" (depth: 1) to the MDN 兼容性数据存储库 .

另请参阅

规范： File API: Directories and System Specification WD

参考：文件系统 API

介绍： Basic Concepts About the File System API

元数据

最后修改： 2019 年 3 月 23 日

在此页