یک تکرارکننده که به اسکریپتها اجازه میدهد روی مجموعهای بالقوه بزرگ از فایلها تکرار شوند. به تکرارکنندههای فایل میتوان از Drive App یا یک 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()); }
روشها
| روش | نوع بازگشتی | شرح مختصر |
|---|---|---|
get Continuation Token() | String | یک توکن دریافت میکند که میتواند برای از سرگیری این تکرار در زمان دیگری استفاده شود. |
has Next() | Boolean | تعیین میکند که آیا فراخوانی تابع next() یک آیتم را برمیگرداند یا خیر. |
next() | File | آیتم بعدی را در مجموعه فایلها یا پوشهها برمیگرداند. |
مستندات دقیق
get Continuation Token()
یک توکن دریافت میکند که میتواند برای از سرگیری این تکرار در زمان بعدی استفاده شود. این روش در صورتی مفید است که پردازش یک تکرارکننده در یک اجرا از حداکثر زمان اجرا فراتر رود. توکنهای ادامه معمولاً به مدت یک هفته معتبر هستند.
بازگشت
String - یک توکن ادامه که میتواند برای از سرگیری این تکرار با مواردی که هنگام تولید توکن در تکرارکننده باقی ماندهاند، استفاده شود.
has Next()
next()
آیتم بعدی را در مجموعه فایلها یا پوشهها برمیگرداند. اگر هیچ آیتمی باقی نمانده باشد، استثنا ایجاد میکند.
بازگشت
File — مورد بعدی در مجموعه.