Enumerator

Non standard
Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

Attention ! Cet objet est une extension non-standard de Microsoft. Elle est uniquement prise en charge par Internet Explorer. Elle n'est pas prise en charge dans les applications Windows 8.x Store.

L'objet Enumerator permet d'énumérer les éléments d'une collection.

Syntaxe

enumObj = new Enumerator([collection])

Paramètres

collection Facultatif: Un objet Collection.

Valeur de retour

enumObj: Le nom de la variable à laquelle l'objet Enumerator est affecté.

Notes

Les collections diffèrent des tableaux car les éléments de la collection ne sont pas accessibles directement. Plutôt que d'utiliser des indices, on déplace le pointeur de l'élément courant vers le prochain élément de la collection.

L'objet Enumerator fournit un moyen d'accéder aux éléments d'une collection à la façon de l'instruction For...Each en VBScript.

Exemples

var bytesPerGB = 1024 * 1024 * 1024;
var fso = new ActiveXObject("Scripting.FileSystemObject");

document.write(fso.Drives);
var e = new Enumerator(fso.Drives);

var driveString = "";

e.moveFirst();
while (e.atEnd() == false) {  
    var drv = e.item();
    driveString += drv.Path + " - ";
    if (drv.IsReady) {
        var freeGB = drv.FreeSpace / bytesPerGB;
        var totalGB = drv.TotalSize / bytesPerGB;
        driveString += freeGB.toFixed(3) + " GB free of ";
        driveString += totalGB.toFixed(3) + " GB";
    } else {
      driveString += "Not Ready";
    }
    driveString += "<br />";
    e.moveNext();
}
document.write(driveString);
// Output: <drive information

Propriétés

L'objet Enumerator ne possède pas de propriété.

Méthodes

Enumerator.atEnd: Renvoie une booléen qui indique si l'énumérateur a atteint la fin de la collection.
Enumerator.item: Renvoie l'élément courant de la collection.
Enumerator.moveFirst: Déplace le pointeur au premier élément de la collection.
Enumerator.moveNext: Déplace le pointeur de la collection sur l'élément suivant.

Prérequis

Cette fonctionnalité est prise en charge pour les modes suivants : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard et Internet Explorer 10 en mode standard. Cette fonctionnalité n'est pas prise en charge dans les applications Windows 8.x Store.