LockedFile
非标准: 该特性是非标准的,请尽量不要在生产环境中使用它!
概要
LockedFile
接口提供了处理给定文件的所有必要锁定工具
属性
LockedFile.fileHandle
(en-US) 只读- 从被打开的锁定文件返回一个
FileHandle
(en-US) 对象。 LockedFile.mode
(en-US) 只读- 访问文件的方式; 返回
readonly
或readwrite。
LockedFile.active
(en-US) 只读- 指示文件是否可以访问,返回 true 或 false。
LockedFile.location
(en-US)- 读/写指针在文件中的位置。
事件处理
LockedFile.oncomplete
- 每次读取或写入操作成功时触发
complete (en-US)
事件。 LockedFile.onabort
- 每次调用
abort()
(en-US) 方法时会触发abort (en-US)
事件。 LockedFile.onerror
- 在每次出现问题时触发
error (en-US)
事件。
方法
LockedFile.getMetadata()
(en-US)- 允许检索文件元数据(上次修改的大小和日期)。返回
FileRequest
对象。 LockedFile.readAsArrayBuffer()
(en-US)- 允许以
ArrayBuffer
形式检索文件内容的一部分。返回FileRequest
对象。 LockedFile.readAsText()
(en-US)- 允许以字符串形式检索文件内容的一部分。返回
FileRequest
对象。 LockedFile.write()
(en-US)- 允许从
location
(en-US) 偏移量开始在文件中写入一些数据。返回FileRequest
对象。 LockedFile.append()
(en-US)- 允许从文件末尾写入一些数据。返回
FileRequest
对象。 LockedFile.truncate()
(en-US)- 允许截断文件的内容。返回
FileRequest
对象。 LockedFile.flush()
(en-US)- 允许保证任何缓冲的数据已被传输到磁盘。
LockedFile.abort()
(en-US)- 使 LockedFile 无效并取消所有正在进行的操作。
标准
Specification | Status | Comment |
---|---|---|
FileSystem API | Editor's Draft | Draft proposal. |