Class FileIterator

DateiIterator

Ein Iterator, mit dem Scripts eine potenziell große Sammlung von Dateien durchgehen können. Auf Dateiiteratoren kann über DriveApp oder eine 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

MethodeRückgabetypKurzbeschreibung
getContinuationToken()StringRuft ein Token ab, mit dem diese Iteration zu einem späteren Zeitpunkt fortgesetzt werden kann.
hasNext()BooleanBestimmt, ob beim Aufrufen von next() ein Element zurückgegeben wird.
next()FileRuft das nächste Element in der Sammlung von Dateien oder Ordnern ab.

Detaillierte Dokumentation

getContinuationToken()

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

hasNext()

Bestimmt, ob beim Aufrufen von next() ein Element zurückgegeben wird.

Rückflug

Boolean – true, wenn next() ein Element zurückgibt; false, wenn nicht

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

File – das nächste Element in der Sammlung