FileSystemDirectoryReader:readEntries() 方法

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

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

语法

js
readEntries(successCallback)
readEntries(successCallback, errorCallback)

参数

successCallback

在目录中的内容被成功检索时调用的回调函数。该函数接收一个输入参数——文件系统条目对象的数组,其中的每一个对象都基于 FileSystemEntry。通常,它们要么是代表标准文件的 FileSystemFileEntry 对象,要么是代表目录的 FileSystemDirectoryEntry 对象。如果目录中没有剩余的文件,或是你已经调用过 FileSystemDirectoryReaderreadEntries() 方法,则数组为空。

errorCallback 可选

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

返回值

无(undefined)。

示例

参见 DataTransferItem.webkitGetAsEntry() 以获取使用此方法的示例代码。

规范

Specification
File and Directory Entries API
# dom-filesystemdirectoryreader-readentries

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
readEntries

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

在 Chrome 77 上,readEntries() 只会返回前 100 个 FileSystemEntry 实例。为了获取所有的实例,请多次调用 readEntries()

参见