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-03-06 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-03-06 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]
