Itérateur qui permet aux scripts d'itérer sur une collection potentiellement importante de fichiers. Les itérateurs de fichiers sont accessibles depuis Drive
ou 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()); }
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
get | String | Récupère un jeton pouvant être utilisé pour reprendre cette itération ultérieurement. |
has | Boolean | Détermine si l'appel de next() renvoie un élément. |
next() | File | Récupère l'élément suivant de la collection de fichiers ou de dossiers. |
Documentation détaillée
get Continuation Token()
Récupère un jeton pouvant ê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épasserait 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 qui sont restés dans l'itérateur lorsque le jeton a été généré
has Next()
next()
Récupère l'élément suivant de la collection de fichiers ou de dossiers. Génère une exception si aucun élément ne reste.
Renvois
File
: élément suivant de la collection