Class FileIterator
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
FileIterator
מחזור (iterator) שמאפשר לסקריפטים לבצע איטרציה על אוסף גדול של קבצים. אפשר לגשת למערכי הקבצים מ-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
| שיטה | סוג הערך המוחזר | תיאור קצר |
getContinuationToken() | String | מקבלת אסימון שאפשר להשתמש בו כדי להמשיך את המחזור הזה במועד מאוחר יותר. |
hasNext() | Boolean | הפונקציה קובעת אם קריאה ל-next() תחזיר פריט. |
next() | File | הפונקציה מקבלת את הפריט הבא באוסף הקבצים או התיקיות. |
מסמכים מפורטים
getContinuationToken()
מקבלת אסימון שאפשר להשתמש בו כדי להמשיך את המחזור הזה במועד מאוחר יותר. השיטה הזו שימושית אם עיבוד של מעבד בפעולה אחת יחרוג ממשך ההפעלה המקסימלי.
בדרך כלל, תוקף של אסימוני המשך הוא שבוע אחד.
חזרה
String – טוקן המשך שאפשר להשתמש בו כדי להמשיך את המחזור הזה עם הפריטים שנותרו במעבד הטבלאות כשהטוקן נוצר
hasNext()
הפונקציה קובעת אם קריאה ל-next() תחזיר פריט.
חזרה
Boolean — true אם next() יחזיר פריט, false אם לא
next()
הפונקציה מקבלת את הפריט הבא באוסף הקבצים או התיקיות. אם לא נותרו פריטים, מתרחשת חריגה.
חזרה
File — הפריט הבא באוסף
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eFileIterator allows scripts to iterate over a large collection of files within Google Drive, accessible via \u003ccode\u003eDriveApp\u003c/code\u003e or a \u003ccode\u003eFolder\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods to check for more files (\u003ccode\u003ehasNext()\u003c/code\u003e), retrieve the next file (\u003ccode\u003enext()\u003c/code\u003e), and manage long iterations with continuation tokens (\u003ccode\u003egetContinuationToken()\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetContinuationToken()\u003c/code\u003e helps to resume iterations that might exceed execution time limits, with tokens typically valid for a week.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ehasNext()\u003c/code\u003e returns \u003ccode\u003etrue\u003c/code\u003e if there are more files to iterate, allowing scripts to control the loop.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003enext()\u003c/code\u003e retrieves the subsequent file in the collection, throwing an exception if none remain.\u003c/p\u003e\n"]]],[],null,["# Class FileIterator\n\nFileIterator\n\nAn iterator that allows scripts to iterate over a potentially large collection of files. File\niterators can be accessed from [DriveApp](/apps-script/reference/drive/drive-app) or a [Folder](/apps-script/reference/drive/folder).\n\n```javascript\n// Log the name of every file in the user's Drive.\nconst files = DriveApp.getFiles();\nwhile (files.hasNext()) {\n const file = files.next();\n Logger.log(file.getName());\n}\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------------|-------------------------------------------|-------------------------------------------------------------------------|\n| [getContinuationToken()](#getContinuationToken()) | `String` | Gets a token that can be used to resume this iteration at a later time. |\n| [hasNext()](#hasNext()) | `Boolean` | Determines whether calling [next()](#next()) will return an item. |\n| [next()](#next()) | [File](/apps-script/reference/drive/file) | Gets the next item in the collection of files or folders. |\n\nDetailed documentation\n----------------------\n\n### `get``Continuation``Token()`\n\nGets a token that can be used to resume this iteration at a later time. This method is useful\nif processing an iterator in one execution would exceed the maximum execution time.\nContinuation tokens are generally valid for one week.\n\n#### Return\n\n\n`String` --- a continuation token that can be used to resume this iteration with the items that\nremained in the iterator when the token was generated\n\n*** ** * ** ***\n\n### `has``Next()`\n\nDetermines whether calling [next()](#next()) will return an item.\n\n#### Return\n\n\n`Boolean` --- `true` if [next()](#next()) will return an item; `false` if not\n\n*** ** * ** ***\n\n### `next()`\n\nGets the next item in the collection of files or folders. Throws an exception if no items\nremain.\n\n#### Return\n\n\n[File](/apps-script/reference/drive/file) --- the next item in the collection"]]
