Ein Objekt, mit dem Scripts eine potenziell große Sammlung von Ordnern durchlaufen können. Auf Ordneriteratoren 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, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann. |
has | Boolean | Bestimmt, 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, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann. Diese Methode ist nützlich, wenn die Verarbeitung eines Iterationsobjekts in einer Ausführung die maximale Ausführungszeit überschreiten würde. 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 verbleiben.
Rückflug
Folder
– das nächste Element in der Sammlung