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