Class FolderIterator

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());
}

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
getContinuationToken()Stringتعرض رمزًا مميّزًا يمكن استخدامه لاستئناف هذه التكرار في وقت لاحق.
hasNext()Booleanتحدّد هذه السمة ما إذا كان طلب next() يعرض عنصرًا.
next()Folderتعرض هذه السمة العنصر التالي في مجموعة الملفات أو المجلدات.

مستندات تفصيلية

getContinuationToken()

تعرض رمزًا مميّزًا يمكن استخدامه لاستئناف هذه التكرار في وقت لاحق. تكون هذه الطريقة مفيدة إذا تجاوزت معالجة مكرّر في عملية تنفيذ واحدة الحد الأقصى لوقت التنفيذ. تكون رموز المتابعة صالحة بشكل عام لمدة أسبوع واحد.

الإرجاع

‫String: رمز مميّز للمتابعة يمكن استخدامه لاستئناف هذه التكرار مع العناصر التي بقيت في المكرّر عند إنشاء الرمز المميّز.

hasNext()

تحدّد هذه السمة ما إذا كان طلب next() يعرض عنصرًا.

الإرجاع

‫Boolean: true إذا كانت next() تعرض عنصرًا، أو false إذا لم تكن كذلك.

next()

تعرض هذه السمة العنصر التالي في مجموعة الملفات أو المجلدات. يطرح استثناءً إذا لم تبقَ أي عناصر.

الإرجاع

‫Folder: العنصر التالي في المجموعة