Class FileIterator

An iterator that allows scripts to iterate over a potentially large collection of files. File iterators can be accessed from DriveApp or a 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());
}

Methods

Method	Return type	Brief description
`getContinuationToken()`	`String`	Gets a token that can be used to resume this iteration at a later time.
`hasNext()`	`Boolean`	Determines whether calling `next()` will return an item.
`next()`	`File`	Gets the next item in the collection of files or folders.

Detailed documentation

`getContinuationToken()`

Gets a token that can be used to resume this iteration at a later time. This method is useful if processing an iterator in one execution would exceed the maximum execution time. Continuation tokens are generally valid for one week.

Return

String — a continuation token that can be used to resume this iteration with the items that remained in the iterator when the token was generated

`hasNext()`

Determines whether calling next() will return an item.

Return

Boolean — true if next() will return an item; false if not

`next()`

Gets the next item in the collection of files or folders. Throws an exception if no items remain.

Return

File — the next item in the collection