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()

另请参阅