DOMTokenList: item() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die item() Methode des DOMTokenList Interfaces gibt ein Element in der Liste zurück, das durch seine Position in der Liste, seinem Index, bestimmt wird.

Hinweis: Diese Methode ist gleichbedeutend mit der Klammernotation. Also ist aList.item(i) das gleiche wie aList[i].

Syntax

js
tokenList.item(index)

Parameter

index

Eine Zahl, die den Index des Elements darstellt, das Sie zurückgeben möchten. Wenn es keine ganze Zahl ist, wird nur der ganzzahlige Teil berücksichtigt.

Rückgabewert

Ein String, der das zurückgegebene Element repräsentiert, oder null, wenn die Zahl größer oder gleich der length der Liste ist.

Ausnahmen

TypeError

Wird ausgelöst, wenn der index nicht in eine ganze Zahl umgewandelt werden kann.

Beispiele

Im folgenden Beispiel rufen wir die Liste der Klassen ab, die auf einem <span> Element als DOMTokenList gesetzt sind, indem wir Element.classList verwenden. Dann rufen wir das letzte Element in der Liste mit item(tokenList.length - 1) ab und schreiben es in das s``<span>'s Node.textContent.

Zuerst das HTML:

html
<span class="a b c"></span>

Jetzt das JavaScript:

js
const span = document.querySelector("span");
const classes = span.classList;
const item = classes.item(classes.length - 1);
span.textContent = item;

Die Ausgabe sieht folgendermaßen aus:

Spezifikationen

Specification
DOM Standard
# ref-for-dom-domtokenlist-item①

Browser-Kompatibilität

BCD tables only load in the browser