Element: getElementsByTagName()-Methode

Die Element.getElementsByTagName()-Methode gibt eine lebendige HTMLCollection von Elementen mit dem angegebenen Tag-Namen zurück.

Alle Nachfahren des spezifizierten Elements werden durchsucht, aber nicht das Element selbst. Die zurückgegebene Liste ist lebendig, was bedeutet, dass sie sich automatisch mit dem DOM-Baum aktualisiert. Daher ist es nicht erforderlich, Element.getElementsByTagName() wiederholt mit demselben Element und denselben Argumenten aufzurufen, wenn sich das DOM zwischen den Aufrufen ändert.

Wenn getElementsByTagName auf ein HTML-Element in einem HTML-Dokument aufgerufen wird, wird das Argument vor dem Suchen in Kleinschreibung konvertiert. Dies ist unerwünscht, wenn versucht wird, camel-cased SVG-Elemente (wie etwa <linearGradient>) in einem HTML-Dokument zu finden. Stattdessen sollte Element.getElementsByTagNameNS() verwendet werden, das die Groß- und Kleinschreibung des Tag-Namens beibehält.

Element.getElementsByTagName ist ähnlich wie Document.getElementsByTagName(), außer dass es nur nach Elementen sucht, die Nachfahren des spezifizierten Elements sind.

getElementsByTagName(tagName)

// Check the status of each data cell in a table
const table = document.getElementById("forecast-table");
const cells = table.getElementsByTagName("td");

for (const cell of cells) {
  const status = cell.getAttribute("data-status");
  if (status === "open") {
    // Grab the data
  }
}