Objet qui permet aux scripts d'itérer sur une collection potentiellement volumineuse de dossiers. Les itérateurs de dossiers sont accessibles à partir d'un Drive, d'un File ou d'un 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()); }
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
get | String | Obtient un jeton qui peut être utilisé pour reprendre cette itération ultérieurement. |
has | Boolean | Détermine si l'appel de next() renvoie un élément. |
next() | Folder | Obtient l'élément suivant dans la collection de fichiers ou de dossiers. |
Documentation détaillée
get Continuation Token()
Obtient un jeton qui peut être utilisé pour reprendre cette itération ultérieurement. Cette méthode est utile si le traitement d'un itérateur en une seule exécution dépasse le temps d'exécution maximal. Les jetons de continuation sont généralement valides pendant une semaine.
Renvois
String : jeton de continuation qui peut être utilisé pour reprendre cette itération avec les éléments restants dans l'itérateur lorsque le jeton a été généré.
has Next()
next()
Obtient l'élément suivant dans la collection de fichiers ou de dossiers. Génère une exception si aucun élément ne reste.
Renvois
Folder : l'élément suivant de la collection.