Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

NodeList : propriété length

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété en lecture seule length de l'interface NodeList retourne le nombre d'éléments contenus dans cet objet.

Valeur

Un entier représentant le nombre d'éléments dans une NodeList.

Exemples

La propriété length est souvent utile dans la programmation DOM. Elle est souvent utilisée pour tester la longueur d'une liste, pour voir si elle existe du tout. Elle est également couramment utilisée comme itérateur dans une boucle for, comme dans cet exemple.

js
// Tous les paragraphes dans le document
const elements = document.getElementsByTagName("p");

// Pour chaque élément de la liste, ajouter l'élément entier en tant que chaîne des caractères HTML
let brut = "";
for (let i = 0; i < elements.length; i++) {
  brut += elements[i].innerHTML;
}

// brut contient maintenant tout le HTML pour les paragraphes

Spécifications

Spécification
DOM
# ref-for-dom-nodelist-length①

Compatibilité des navigateurs