דף זה תורגם על ידי Cloud Translation API.

Class FolderIterator

אובייקט שמאפשר לסקריפטים לבצע איטרציה על אוסף גדול של תיקיות. אפשר לגשת למערכי החזרה של התיקיות מ-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

שיטה	סוג הערך המוחזר	תיאור קצר
`getContinuationToken()`	`String`	מקבלת אסימון שאפשר להשתמש בו כדי להמשיך את המחזור הזה במועד מאוחר יותר.
`hasNext()`	`Boolean`	הפונקציה קובעת אם קריאה ל-`next()` תחזיר פריט.
`next()`	`Folder`	הפונקציה מקבלת את הפריט הבא באוסף הקבצים או התיקיות.

מסמכים מפורטים

`getContinuationToken()`

מקבלת אסימון שאפשר להשתמש בו כדי להמשיך את המחזור הזה במועד מאוחר יותר. השיטה הזו שימושית אם עיבוד של מעבד בפעולה אחת יחרוג ממשך ההפעלה המקסימלי. בדרך כלל, תוקף של אסימוני המשך הוא שבוע אחד.

חזרה

String – טוקן המשך שאפשר להשתמש בו כדי להמשיך את המחזור הזה עם הפריטים שנותרו במעבד הטבלאות כשהטוקן נוצר

`hasNext()`

הפונקציה קובעת אם קריאה ל-next() תחזיר פריט.

חזרה

Boolean — true אם next() יחזיר פריט, false אם לא

`next()`

הפונקציה מקבלת את הפריט הבא באוסף הקבצים או התיקיות. אם לא נותרו פריטים, מתרחשת חריגה.

חזרה

Folder — הפריט הבא באוסף