HTMLCollection

L'interface HTMLCollection est constitue d'une collection gnrique ( la manire d'un tableau similaire arguments) d'lments (dans l'ordre du document) et offre des mthodes et des proprits pour slectionner ces lments dans la liste.

Une HTMLCollection dans le DOM HTML est  dynamique  ; elle est automatiquement mise jour lorsque le document sous-jacent est modifi. Pour cette raison, il est conseill d'en faire une copie (par exemple, en utilisant Array.from) pour itrer si vous ajoutez, dplacez ou supprimez des nuds.

Cette interface est appele HTMLCollection pour des raisons historiques (avant DOM4, les collections implmentant cette interface pouvaient uniquement tres constitues d'lements HTML).

Cette interface tait une tentative de crer une liste non modifiable (angl.) et continue d'tre prise en charge uniquement pour ne pas casser le code qui l'utilise dj. Les API modernes reprsentent les structures de liste l'aide de types bass sur les tableaux JavaScript, ce qui rend de nombreuses mthodes de tableau disponibles, tout en imposant des smantiques supplmentaires leur utilisation (comme rendre leurs lments en lecture seule).

Ces raisons historiques ne signifient pas que vous, en tant que dveloppeureuse, devez viter HTMLCollection. Vous ne crez pas vous-mme d'objets HTMLCollection, mais vous les obtenez via des API comme Document.getElementsByClassName(), et ces API ne sont pas obsoltes. Cependant, faites attention aux diffrences smantiques avec un vritable tableau.

var elem1, elem2;

// document.forms est une HTMLCollection

elem1 = document.forms[0];
elem2 = document.forms.item(0);

alert(elem1 === elem2); // affiche : "true" (vrai)

elem1 = document.forms.myForm;
elem2 = document.forms.namedItem("myForm");

alert(elem1 === elem2); // affiche : "true"

elem1 = document.forms["named.item.with.periods"];