Obiekt, który umożliwia skryptom iterację po potencjalnie dużej kolekcji folderów. Do iteratorów folderów można uzyskać dostęp z Drive, File lub 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()); }
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
get | String | Pobiera token, którego można użyć do wznowienia tej iteracji w późniejszym czasie. |
has | Boolean | Określa, czy wywołanie funkcji next() zwraca element. |
next() | Folder | Pobiera następny element w kolekcji plików lub folderów. |
Szczegółowa dokumentacja
get Continuation Token()
Pobiera token, którego można użyć do wznowienia tej iteracji w późniejszym czasie. Ta metoda jest przydatna, jeśli przetwarzanie iteratora w jednym wykonaniu przekracza maksymalny czas wykonania. Tokeny kontynuacji są zwykle ważne przez tydzień.
Powrót
String – token kontynuacji, którego można użyć do wznowienia tej iteracji z elementami, które pozostały w iteratorze w momencie wygenerowania tokena.
has Next()
next()
Pobiera następny element w kolekcji plików lub folderów. Zgłasza wyjątek, jeśli nie ma już żadnych elementów.
Powrót
Folder – następny element w kolekcji.