Ein Iterator, mit dem in Skripts eine potenziell große Sammlung von Dateien durchlaufen werden kann. Auf Datei-Iteratoren kann über Drive oder einen Folder zugegriffen werden.
// 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()); }
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() | File | 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
File: Das nächste Element in der Sammlung.