Class FolderIterator

FolderIterator

Obiekt, który umożliwia skryptom przeszukiwanie potencjalnie dużej kolekcji folderów. Do folderów iteracji można uzyskać dostęp z poziomu DriveApp, File lub Folder. 

// 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());
}

Metody

MetodaZwracany typKrótki opis
getContinuationToken()StringPobiera token, który można wykorzystać do wznowienia tej iteracji w późniejszym czasie.
hasNext()BooleanOkreśla, czy wywołanie next() spowoduje zwrot produktu.
next()FolderPobiera następny element z kolekcji plików lub folderów.

Szczegółowa dokumentacja

getContinuationToken()

Pobiera token, który można wykorzystać do wznowienia tej iteracji w późniejszym czasie. Ta metoda jest przydatna, jeśli przetworzenie iteratora w jednym wykonaniu przekroczy maksymalny czas wykonania. Tokeny kontynuacji są zwykle ważne przez tydzień.

Powrót

String – token kontynuacji, który można wykorzystać do wznowienia iteracji z elementami, które pozostały w iteratorze w momencie wygenerowania tokena.

hasNext()

Określa, czy wywołanie next() spowoduje zwrot produktu.

Powrót

Boolean – true, jeśli next() zwróci element; false, jeśli nie.

next()

Pobiera następny element z kolekcji plików lub folderów. Wyjątek jest zgłaszany, jeśli nie ma żadnych elementów.

Powrót

Folder – następny element w kolekcji.