Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 ⁨Juli 2015⁩.

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

Hinweis: Diese Methode ist äquivalent zur Klammernotation. Also ist list.item(i) dasselbe wie list[i].

Syntax

js
item(index)

Parameter

index

Eine Zahl, die den Index des zurückzuergebenden Elements repräsentiert. Wenn es sich nicht um eine ganze Zahl handelt, 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 an einem <span>-Element als DOMTokenList festgelegt sind, indem wir Element.classList verwenden. Wir rufen dann das letzte Element in der Liste mit item(tokenList.length - 1) ab und schreiben es in das <span>'s Node.textContent.

Zuerst das HTML:

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

Nun 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
# ref-for-dom-domtokenlist-item①

Browser-Kompatibilität