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