Объект Enumerator

С помощью объекта Enumerator можно получить доступ к любому элементу коллекции (в VBScript для этого служит цикл For Each).

Коллекцией в языке JScript называется множество элементов, которое отличается от массива тем, что к элементам коллекции нельзя получить прямой доступ с помощью индексов — можно только перемешать указатель текущего элемента на самый первый или следующий относительно текущего элемент.

Для создания нового объекта встроенного класса Enumerator используется конструктор следующего вида:

var е = new Enumerator(collection);

collection

Коллекция, для доступа к элементам которой и создается объект класса Enumerator. Сами коллекции обычно являются свойствами других объектов.

У объекта Enumerator нет свойств, а есть только 4 метода. Они позволяют получать доступ к начальному, следующему и текущему элементу коллекции и определить, достигнут ли конец коллекции.

• Метод atEnd() возвращает true, если текущий элемент коллекции является последним в ней, и false в противном случае.
• Метод item() возвращает текущий элемент коллекции. Если коллекция пуста или текущий элемент не определен, то возвращается значение undefined.
• Метод moveFirst() перемещает указатель на первый элемент коллекции.
• Метод moveNext() перемещает указатель на следующий элемент коллекции.

Примеры

//Объявляем переменные

var FSO, Folder, Files, s;

//Создаем объект FileSystemObject

FSO = WScript.CreateObject("Scripting.FileSystemObject");

// Создаем объект Folder для корневого  диска С:\AA

Folder=FSO.GetFolder("С:\\AA");

// Создаем коллекцию файлов каталога

Files = new Enumerator(Folder.Files);

//Цикл по всем файлам

for (Files.moveFirst(); !Files.atEnd; Files.moveNext) {

//Добавляем строку с именем файла

s+=Files.item.Name+"\n";

//Выводим полученные строки на экран }

WScript.Echo(s);

---

var x;
var fso = new ActiveXObject("Scripting.FileSystemObject");
var fc = new Enumerator(fso.Drives);
for (fc.moveFirst(); !fc.atEnd(); fc.moveNext()) 
 { x = fc.item();
   s='Drive '+x.DriveLetter+': ';
   if (x.DriveType == 0) s += "неизвестное устройство ";
   if (x.DriveType == 1) s += "устройство со сменным носителем ";
   if (x.DriveType == 2) s += "жёсткий диск " ;
   if (x.DriveType == 3) s += "сетевой диск ";
   if (x.DriveType == 4) s += "CD-ROM ";
   if (x.DriveType == 5) s += "RAM-диск ";
   if (x.IsReady) 
    { namedisk=(x.DriveType == 3)?x.ShareName:x.VolumeName;
      s += " Name=" +((namedisk.length > 0 )? namedisk : "[NO NAME] ");
      s +=" FileSystem="+x.FileSystem;
      s +=" FreeSpace="+Math.floor(x.FreeSpace/1024) +"КБ";
    } 
   else s +=" [disk not ready]";
   WScript.Echo(s);
 }