אובייקט שמאפשר לסקריפטים לבצע איטרציה על אוסף גדול של תיקיות. אפשר לגשת לאיטרטורים של תיקיות מ-DriveApp, מ-File או מ-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()); }
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
get | String | מקבלים טוקן שאפשר להשתמש בו כדי להמשיך את האיטרציה הזו מאוחר יותר. |
has | Boolean | קובעת אם הקריאה ל-next() מחזירה פריט. |
next() | Folder | מחזירה את הפריט הבא באוסף הקבצים או התיקיות. |
תיעוד מפורט
getContinuationToken()
מקבלים טוקן שאפשר להשתמש בו כדי להמשיך את האיטרציה הזו מאוחר יותר. השיטה הזו שימושית אם העיבוד של איטרטור בהפעלה אחת חורג ממשך ההפעלה המקסימלי. אסימוני המשך תקפים בדרך כלל למשך שבוע.
חזרה
String – טוקן המשך שאפשר להשתמש בו כדי להמשיך את האיטרציה הזו עם הפריטים שנשארו באיטרטור כשהטוקן נוצר.
hasNext()
next()
מחזירה את הפריט הבא באוסף הקבצים או התיקיות. הפונקציה מחזירה חריגה אם לא נשארו פריטים.
חזרה
Folder – הפריט הבא באוסף.