Obiekt, który umożliwia skryptom powtarzanie tych samych zadań na potencjalnie dużej kolekcji folderów. Algorytmy iteracyjne są dostępne za pomocą polecenia DriveApp
, File
i Folder
.
// Log the name of every folder in the user's Drive. var folders = DriveApp.getFolders(); while (folders.hasNext()) { var folder = folders.next(); Logger.log(folder.getName()); }
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getContinuationToken() | String | Pobiera token, którego można użyć do wznowienia tej iteracji w późniejszym czasie. |
hasNext() | Boolean | Określa, czy wywołanie metody next() spowoduje zwrócenie elementu. |
next() | Folder | Pobiera następny element w kolekcji plików lub folderów. |
Szczegółowa dokumentacja
getContinuationToken()
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 spowodowałoby przekroczenie maksymalnego czasu wykonania. Tokeny kontynuacji są zwykle ważne przez tydzień.
Powroty
String
– token kontynuacji, który umożliwia wznowienie tej iteracji z elementami, które pozostały w iteratorze podczas generowania tokena
hasNext()
next()
Pobiera następny element w kolekcji plików lub folderów. Jeśli nie ma żadnych elementów, zgłasza wyjątek.
Powroty
Folder
– następny element w kolekcji,