FileSystemDirectoryReader:readEntries() 方法
FileSystemDirectoryReader
接口的 readEntries()
方法用于检索正在读取的目录中的目录条目,并将它们以数组的形式传递给提供的回调函数。
数组中的对象都是 FileSystemEntry
实例。它们要么是代表标准文件的 FileSystemFileEntry
对象,要么是代表目录的 FileSystemDirectoryEntry
对象。
语法
js
readEntries(successCallback)
readEntries(successCallback, errorCallback)
参数
successCallback
-
在目录中的内容被成功检索时调用的回调函数。该函数接收一个输入参数——文件系统条目对象的数组,其中的每一个对象都基于
FileSystemEntry
。通常,它们要么是代表标准文件的FileSystemFileEntry
对象,要么是代表目录的FileSystemDirectoryEntry
对象。如果目录中没有剩余的文件,或是你已经调用过FileSystemDirectoryReader
的readEntries()
方法,则数组为空。 errorCallback
可选-
一个在目录读取发生错误时调用的回调函数。它接收一个输入参数——一个
DOMException
对象,用于描述发生的错误。
返回值
无(undefined
)。
示例
参见 DataTransferItem.webkitGetAsEntry()
以获取使用此方法的示例代码。
规范
Specification |
---|
File and Directory Entries API # dom-filesystemdirectoryreader-readentries |
浏览器兼容性
BCD tables only load in the browser
在 Chrome 77 上,readEntries()
只会返回前 100 个 FileSystemEntry
实例。为了获取所有的实例,请多次调用 readEntries()
。