אובייקט שמאפשר לסקריפטים לבצע איטרציה על אוסף גדול של תיקיות. אפשר לגשת לאיטרטורים של תיקיות מ-Drive, מ-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 | מחזירה את הפריט הבא באוסף הקבצים או התיקיות. |
תיעוד מפורט
get Continuation Token()
מקבלים טוקן שאפשר להשתמש בו כדי להמשיך את האיטרציה הזו מאוחר יותר. השיטה הזו שימושית אם העיבוד של איטרטור בהפעלה אחת חורג ממשך ההפעלה המקסימלי. אסימוני המשך תקפים בדרך כלל למשך שבוע.
חזרה
String – טוקן המשך שאפשר להשתמש בו כדי להמשיך את האיטרציה הזו עם הפריטים שנשארו באיטרטור כשהטוקן נוצר.
has Next()
next()
מחזירה את הפריט הבא באוסף הקבצים או התיקיות. הפונקציה מעלה חריגה אם לא נשארו פריטים.
חזרה
Folder – הפריט הבא באוסף.