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 : méthode item()

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 méthode item() de l'interface NodeList retourne un nœud depuis une NodeList par l'index. Cette méthode ne lance pas d'exceptions tant que vous fournissez des arguments. Une valeur null est retournée si l'index est hors des limites et une TypeError est levée si aucun argument n'est fourni.

En JavaScript, au lieu d'appeler nodeList.item(index), vous pouvez également accéder directement à un index, comme nodeList[index].

Syntaxe

js
item(index)

Paramètres

index

L'index du nœud à récupérer. L'index commence à zéro.

Valeur de retour

Le nœud d'un index dans la nodeList retourné par la méthode item.

Exceptions

TypeError

Levée si aucun argument n'est fourni.

Exemples

js
const tableaux = document.getElementsByTagName("table");
const premierTableau = tableaux.item(1); // ou tableaux[1] - retourne le second tableau dans le DOM

Spécification

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

Compatibilité des navigateurs