Um objeto que permite que os scripts iterem em uma coleção possivelmente grande de pastas. pasta;
Os iteradores podem ser acessados de DriveApp
, File
ou Folder
.
// Log the name of every folder in the user's Drive. var folders = DriveApp.getFolders(); while (folders.hasNext()) { var folder = folders.next(); Logger.log(folder.getName()); }
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
getContinuationToken() | String | Recebe um token que pode ser usado para retomar essa iteração mais tarde. |
hasNext() | Boolean | Determina se chamar next() vai retornar um item. |
next() | Folder | Acessa o próximo item na coleção de arquivos ou pastas. |
Documentação detalhada
getContinuationToken()
Recebe um token que pode ser usado para retomar essa iteração mais tarde. Esse método é útil se o processamento de um iterador em uma execução exceder o tempo máximo de execução. Os tokens de continuação geralmente são válidos por uma semana.
Retornar
String
: um token de continuação que pode ser usado para retomar essa iteração com os itens que
permaneceu no iterador quando o token foi gerado
hasNext()
next()
Acessa o próximo item na coleção de arquivos ou pastas. Gera uma exceção quando não há itens permanecem.
Retornar
Folder
: o próximo item na coleção.