HTMLCollection: namedItem() method - Web APIs | MDN

Syntax

Parameters

key

A string representing the value of the id or name attribute of the element we are looking for.

Return value

The first Element in the HTMLCollection matching the key, or null if there is none. Always returns null if key is the empty string.

Example

HTML

html

<div id="personal">
  <span name="title">Dr.</span>
  <span name="first-name">Carina</span>
  <span name="last-name">Anand</span>
  <span id="degree">(MD)</span>
</div>

JavaScript

js

const container = document.getElementById("personal");

// Returns the HTMLSpanElement with the name "title" if no such element exists null is returned
const titleSpan = container.children.namedItem("title");

// The following variants return undefined instead of null if there's no element with a matching name or id
const firstNameSpan = container.children["first-name"];
const lastNameSpan = container.children["last-name"];

// Returns the span element with the id "degree"
const degreeSpan = container.children.namedItem("degree");

const output = document.createElement("div");
output.textContent = `Result: ${titleSpan.textContent} ${firstNameSpan.textContent} ${lastNameSpan.textContent} ${degreeSpan.textContent}`;

container.insertAdjacentElement("afterend", output);

Specifications

Specification
DOM
# dom-htmlcollection-nameditem-key

Browser compatibility

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.