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.
L'objet Enumerator permet d'énumérer les éléments d'une collection.
Syntaxe
enumObj = new Enumerator([collection])
Paramètres
collectionFacultatif- Un objet
Collection.
Valeur de retour
enumObj- Le nom de la variable à laquelle l'objet
Enumeratorest 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.