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

另見