Class FolderIterator

FolderIterator

這個物件可讓指令碼疊代處理可能包含大量資料夾的集合。資料夾迭代器可從 DriveApp、File 或 Folder 存取。

// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
  const folder = folders.next();
  Logger.log(folder.getName());
}

方法

方法	傳回類型	簡短說明
getContinuationToken()	String	取得權杖，之後可用於繼續執行這個疊代。
hasNext()	Boolean	判斷呼叫 next() 是否會傳回項目。
next()	Folder	取得檔案或資料夾集合中的下一個項目。

內容詳盡的說明文件

getContinuationToken()

取得權杖，之後可用於繼續執行這個疊代。如果一次執行迭代器時超過執行時間上限，這個方法就很有用。接續符記的效期通常為一週。

回攻員

String：繼續符記，可用於繼續這個疊代，並處理符記產生時疊代器中剩餘的項目。

---

hasNext()

判斷呼叫 next() 是否會傳回項目。

回攻員

Boolean：如果 next() 傳回項目，則為 true；否則為 false。

---

next()

取得檔案或資料夾集合中的下一個項目。如果沒有任何項目，就會擲回例外狀況。

回攻員

Folder：集合中的下一個項目。