Ein Objekt, mit dem Skripts eine potenziell große Sammlung von Ordnern durchlaufen können. Auf Ordner-Iteratoren kann über Drive, File oder Folder zugegriffen werden.
// 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()); }
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
get | String | Ruft ein Token ab, das verwendet werden kann, um diese Iteration zu einem späteren Zeitpunkt fortzusetzen. |
has | Boolean | Legt fest, ob beim Aufrufen von next() ein Element zurückgegeben wird. |
next() | Folder | Ruft das nächste Element in der Sammlung von Dateien oder Ordnern ab. |
Detaillierte Dokumentation
get Continuation Token()
Ruft ein Token ab, das verwendet werden kann, um diese Iteration zu einem späteren Zeitpunkt fortzusetzen. Diese Methode ist nützlich, wenn die Verarbeitung eines Iterators in einer Ausführung die maximale Ausführungszeit überschreitet. Fortsetzungstokens sind in der Regel eine Woche lang gültig.
Rückflug
String: Ein Fortsetzungstoken, mit dem diese Iteration mit den Elementen fortgesetzt werden kann, die beim Generieren des Tokens im Iterator verblieben sind.
has Next()
next()
Ruft das nächste Element in der Sammlung von Dateien oder Ordnern ab. Löst eine Ausnahme aus, wenn keine Elemente mehr vorhanden sind.
Rückflug
Folder: Das nächste Element in der Sammlung.