Class FolderIterator
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
FolderIterator
كائن يتيح للبرامج النصية تكرار مجموعة كبيرة محتملة من المجلدات. يمكن الوصول إلى أدوات تكرار المجلدات من DriveApp أو File أو Folder.
// Log the name of every folder in the user's Drive.constfolders=DriveApp.getFolders();while(folders.hasNext()){constfolder=folders.next();Logger.log(folder.getName());}
تعرض هذه السمة العنصر التالي في مجموعة الملفات أو المجلدات.
مستندات تفصيلية
getContinuationToken()
يحصل على رمز مميّز يمكن استخدامه لاستئناف هذه التكرار في وقت لاحق. تكون هذه الطريقة مفيدة
إذا تجاوزت معالجة مكرّر في عملية تنفيذ واحدة الحد الأقصى لوقت التنفيذ. تكون رموز مواصلة البحث صالحة لمدة أسبوع واحد بشكل عام.
الإرجاع
String: رمز مميّز للمتابعة يمكن استخدامه لاستئناف هذه التكرار مع العناصر التي بقيت في المكرّر عند إنشاء الرمز المميّز.
hasNext()
تحدّد هذه السمة ما إذا كان طلب next() يعرض عنصرًا.
الإرجاع
Boolean — true إذا كانت الدالة next() تعرض عنصرًا، أو false إذا لم تعرض عنصرًا
next()
تعرض هذه السمة العنصر التالي في مجموعة الملفات أو المجلدات. يطرح هذا الإجراء استثناءً إذا لم تبقَ أي عناصر.
تاريخ التعديل الأخير: 2026-04-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-04-13 (حسب التوقيت العالمي المتفَّق عليه)"],[],["FolderIterator allows iterating over a large collection of folders. Key actions include using `hasNext()` to check for the next item and `next()` to retrieve it. `getContinuationToken()` provides a token to resume iteration later, helpful for large collections. The example shows how to log every folder's name in a user's Drive, demonstrating iteration through the folder collection. The iterator returns folder objects and can throw an exception if no items remain.\n"]]
