FileSystemDirectoryReader: readEntries() 方法
readEntries()
方法是 FileSystemDirectoryReader
接口的一部分,它检索正在读取目录中的目录条目,并将它们作为数组传递给提供的回调函数。
数组中的对象都基于 FileSystemEntry
。通常,它们要么是 FileSystemFileEntry
对象(表示标准文件),要么是 FileSystemDirectoryEntry
对象(表示目录)。
语法
js
readEntries(successCallback)
readEntries(successCallback, errorCallback)
参数
successCallback
-
当目录内容已检索到时调用的函数。该函数接收一个输入参数:一个文件系统条目对象数组,每个对象都基于
FileSystemEntry
。通常,它们要么是FileSystemFileEntry
对象(表示标准文件),要么是FileSystemDirectoryEntry
对象(表示目录)。如果不再有文件,或者你已经在这个FileSystemDirectoryReader
上调用过readEntries()
,那么该数组为空。 errorCallback
可选-
如果在从目录中读取时发生错误,则调用的回调函数。它接收一个输入参数:一个
DOMException
对象,描述发生的错误。
返回值
无 (undefined
).
示例
请参阅 DataTransferItem.webkitGetAsEntry()
,以获取使用此方法的示例代码。
规范
规范 |
---|
文件和目录条目 API # dom-filesystemdirectoryreader-readentries |
浏览器兼容性
BCD 表格仅在浏览器中加载
在 Chrome 77 中,readEntries()
仅返回前 100 个 FileSystemEntry
实例。为了获取所有实例,必须多次调用 readEntries()
。