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/filesystemfileentry/index.html | 174 +++++++++++++++++++++ 1 file changed, 174 insertions(+) create mode 100644 files/zh-cn/web/api/filesystemfileentry/index.html (limited to 'files/zh-cn/web/api/filesystemfileentry') diff --git a/files/zh-cn/web/api/filesystemfileentry/index.html b/files/zh-cn/web/api/filesystemfileentry/index.html new file mode 100644 index 0000000000..8fcca325a1 --- /dev/null +++ b/files/zh-cn/web/api/filesystemfileentry/index.html @@ -0,0 +1,174 @@ +--- +title: FileSystemFileEntry +slug: Web/API/FileSystemFileEntry +translation_of: Web/API/FileSystemFileEntry +--- +
{{APIRef("File System API")}}{{Non-standard_header}}
+ +

文件系统 API 的 FileSystemFileEntry 接口表示文件系统中的文件。它提供了属性,描述文件的属性,以及 {{domxref("FileSystemFileEntry.file", "file()")}} 方法,它创建了可以用于读取文件的 {{domxref("File")}} 对象。

+ +
+

由于这是个非标准 API,它的规范当前并不在标准化过程中。重要的是要记住,并不是所有浏览器都实现了它,并且实现它的浏览器可能仅仅实现一小部分。点击 {{anch("Browser compatibility")}} 来查看更多细节。

+
+ +

属性

+ +

从它的父接口 {{domxref("FileSystemEntry")}} 继承属性,但是这个接口没有独特的属性。

+ +

方法

+ +
+
{{domxref("FileSystemFileEntry.file", "file()")}}
+
创建新的 {{domxref("File")}} 对象,它可以用于读取文件。
+
+ +

废弃的方法

+ +
+
{{domxref("FileSystemFileEntry.createWriter", "createWriter()")}} {{obsolete_inline}}
+
创建新的 {{domxref("FileWriter")}} 对象,它允许写入由文件系统条目表示的对象。
+
+ +

基本概念

+ +

为了向文件写入内容,通过调用 {{domxref("FileSystemFileEntry.createWriter", "createWriter()")}} 创建 {{domxref("FileWriter")}} 对象。为了读取文件,通过调用 {{domxref("FileSystemFileEntry.file", "file()")}},获取表示其内容的 {{domxref("File")}} 对象。

+ +

示例

+ +

下面的代码创建了一个空文件,叫做 "log.txt" (如果不存在的话),并使用文本 "Meow" 来填充。在成功的回调中,设置了事件处理器,来处理 {{event("error")}} error 和 {{event("writeend")}} 事件。通过创建 blob,向其追加文本,以及将 blob 传递给  {{domxref("FileWriter.write()")}},文本数据写入了文件。

+ +
function onInitFs(fs) {
+  fs.root.getFile('log.txt', {create: true}, function(fileEntry) {
+
+    // Create a FileWriter object for our FileSystemFileEntry (log.txt).
+    fileEntry.createWriter(function(fileWriter) {
+      fileWriter.onwriteend = function(e) {
+        console.log('Write completed.');
+      };
+
+      fileWriter.onerror = function(e) {
+        console.log('Write failed: ' + e.toString());
+      };
+
+      // Create a new Blob and write it to log.txt.
+      var bb = new BlobBuilder();
+      bb.append('Meow');
+
+      fileWriter.write(bb.getBlob('text/plain'));
+    }, errorHandler);
+
+  }, errorHandler);
+
+}
+
+window.requestFileSystem(window.TEMPORARY, 1024*1024, onInitFs, errorHandler);
+ +

规范

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('File System API')}}{{Spec2('File System API')}}Draft of proposed API
+ +

这个 API 没有官方的 W3C 或者 WHATWG 规范。

+ +

浏览器兼容性

+ +

{{ CompatibilityTable }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerMicrosoft EdgeOperaSafari (WebKit)
Basic support13 {{ property_prefix("webkit") }}{{CompatVersionUnknown}}{{ CompatGeckoDesktop(50) }}{{ CompatNo }}{{CompatVersionUnknown}}[2]{{ CompatNo }}{{ CompatNo }}
createWriter()13 {{ property_prefix("webkit") }}{{CompatNo}}{{ CompatNo }}[1]{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support{{ CompatNo }}0.16{{ property_prefix("webkit") }}{{CompatVersionUnknown}}{{CompatGeckoMobile(50)}}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}
createWriter(){{ CompatNo }}0.16{{ property_prefix("webkit") }}{{CompatNo}}{{ CompatNo }}[1]{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}
+
+ +

[1] 虽然从 Firefox 50 开始,存在 createWriter() 方法,它是不受支持的,并且会立即报告 NS_ERROR_DOM_SECURITY_ERR 错误给错误回调。这个方法在 Firefox 52 中彻底移除。

+ +

[2] Microsoft Edge 实现了这个接口,作为 WebKitEntry 接口的一部分,它是用于 {{domxref("FileSystemEntry")}} 的名称。

+ +

另见

+ + -- cgit v1.2.3-54-g00ecf