Iterator, który umożliwia skryptom iterowanie po potencjalnie dużym zbiorze plików. Do iteratorów plików można uzyskać dostęp z poziomu Drive lub Folder.
// Log the name of every file in the user's Drive. const files = DriveApp.getFiles(); while (files.hasNext()) { const file = files.next(); Logger.log(file.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() | File | 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
File – następny element w kolekcji.