FileSystemDirectoryReader: readEntries() 方法

FileSystemDirectoryReader 接口的 readEntries() 方法会检索正在读取的目录中的条目,并将它们以数组的形式传递给提供的回调函数。

数组中的对象都基于 FileSystemEntry。通常,它们要么是 FileSystemFileEntry 对象,代表标准文件,要么是 FileSystemDirectoryEntry 对象,代表目录。

语法

js
readEntries(successCallback)
readEntries(successCallback, errorCallback)

参数

successCallback

当目录内容检索完毕后调用的函数。该函数接收一个输入参数:一个文件系统条目对象数组,每个对象都基于 FileSystemEntry。通常,它们要么是 FileSystemFileEntry 对象,代表标准文件,要么是 FileSystemDirectoryEntry 对象,代表目录。如果没有剩余文件,或者您已经在此 FileSystemDirectoryReader 上调用过 readEntries(),则该数组为空。

errorCallback 可选

在读取目录时发生错误时调用的回调函数。它接收一个输入参数:一个 DOMException 对象,描述发生的错误。

返回值

无(undefined)。

示例

请参阅 DataTransferItem.webkitGetAsEntry() 了解使用此方法的示例代码。

规范

规范
File and Directory Entries API
# dom-filesystemdirectoryreader-readentries

浏览器兼容性

在 Chrome 77 中,readEntries() 只会返回前 100 个 FileSystemEntry 实例。为了获得所有实例,必须多次调用 readEntries()

另见