From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/localfilesystemsync/index.html | 227 +++++++++++++++++++++ 1 file changed, 227 insertions(+) create mode 100644 files/zh-cn/web/api/localfilesystemsync/index.html (limited to 'files/zh-cn/web/api/localfilesystemsync/index.html') diff --git a/files/zh-cn/web/api/localfilesystemsync/index.html b/files/zh-cn/web/api/localfilesystemsync/index.html new file mode 100644 index 0000000000..799d89ee80 --- /dev/null +++ b/files/zh-cn/web/api/localfilesystemsync/index.html @@ -0,0 +1,227 @@ +--- +title: LocalFileSystemSync +slug: Web/API/LocalFileSystemSync +translation_of: Web/API/LocalFileSystemSync +--- +
{{APIRef("File System API")}}{{non-standard_header()}}
+ +

文件系统 API 的 LocalFileSystemSync 接口允许你访问沙盒中的文件系统。它的目的是和 WebWorkers 一起使用。方法由 worker 对象实现。

+ +

关于这个文档

+ +

这个文档最后更新于 2012 年 3 月 2 日，并遵循 W3C 规范（工作草案），起草于 2011 年 4 月 19 日。

+ +

这个规范或多或少已经废弃，没有得到大量的关注。

+ +

基本概念

+ +

通过在 WebWorker 中请求 LocalFileSystemSync 对象，你可以请求访问沙盒文件系统。window 对象的全局方法 requestFileSystemSync() 和 resolveLocalFileSystemSyncURL() 暴露在 Worker 的全局域中。调用 window.requestFileSystemSync() 来为你的 Web 应用创建新的存储器。

+ +

更多概念请见 异步 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*/);
+ +

由于你使用了同步 API，你并不需要成功或者错误回调。

+ +

方法概览

+ + + + + + + + + + +
FileSystemSync requestFileSystemSync (in unsigned short type, in long long size) raises FileException;
EntrySync resolveLocalFileSystemSyncURL (in DOMString url) raises FileException;
+ +

常量

+ + + + + + + + + + + + + + + + + + + + + +
常量值描述
TEMPORARY0 +

暂时的存储器，可由浏览器自主移除。

+
PERSISTENT1存在于浏览器的存储器，除非用户或者应用移除它。
+ +

方法

+ +

requestFileSystemSync()

+ +

请求一个文件系统，数据应该储存到这里。通过在 WebWorker 中使用这个全局方法（window.requestFileSystemSync()）请求 LocalFileSystemSync 对象，来访问沙盒文件系统。 [ RESEARCH ]

+ +
FileSystemSync requestFileSystemSync(
+  in unsigned short type,
+  in unsigned long long size
+);
+ +
参数
+ +
+
type
+
文件系统的储存类型。值为 TEMPORARY 或 PERSISTENT。
+
size
+
存储器的空间—按字节—你需要将其用于你的应用。
+
+ +
返回值
+ +
+
FileSystemSync
+
表示文件系统的对象。
+
+ +
异常
+ +

这个方法可能产生 FileException ，带有下面的错误代码：

+ + + + + + + + + + + + +
异常描述
SECURITY_ERROR应用没有权限来访问文件系统接口。例如，你不能执行 file:// 。更多细节请见 基本概念的文章。
+ +

resolveLocalFileSystemSyncURL()

+ +

允许用户来检索文件或者目录的 Entry ，由本地 URL 引用。

+ +
void resolveLocalFileSystemURL(
+  in DOMString url
+);
+ +
参数
+ +
+
url
+
文件系统中的本地文件的 URL。
+
+ +
返回值
+ +
+
EntrySync
+
表示文件系统中条目的对象。
+
+ +
异常
+ +

这个方法可能产生 FileException ，带有下列错误代码：

+ + + + + + + + + + + + + + + + + + + + + + +
异常描述
ENCODING_ERRURL 语法错误。
NOT_FOUND_ERRURL 结构正确，但是指向了不存在的资源。
SECURITY_ERR应用没有权限来访问文件系统接口。
+ +

浏览器兼容性

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support13{{ property_prefix("webkit") }}{{ CompatNo() }}{{ CompatNo() }}{{ CompatNo() }}{{ CompatNo() }}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support{{ CompatNo() }}0.16{{ property_prefix("webkit") }}{{ CompatNo() }}{{ CompatNo() }}{{ CompatNo() }}{{ CompatNo() }}
+
+ +

另见

+ +

规范：{{ spec("http://dev.w3.org/2009/dap/file-system/pub/FileSystem/", "File API: Directories and System Specification", "WD") }}

+ +

参考：文件系统 API

+ +

简介： 文件系统 API 的基本概念。

-- cgit v1.2.3-54-g00ecf