W3cubDocs

/Web APIs

NamedNodeMap: getNamedItem() method

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⁩.

The getNamedItem() method of the NamedNodeMap interface returns the Attr corresponding to the given name, or null if there is no corresponding attribute.

Note: This method is also called when you use the operator [] syntax. So, myMap[str] is equivalent to myMap.getNamedItem(str) where str is a string.

Syntax

getNamedItem(name)
[name]

Parameters

name

A string with the name of the desired attribute.

Return value

An Attr corresponding to the name given in parameter, or null if none has been found.

Example

<pre test="test"></pre>
const pre = document.querySelector("pre");
const attrMap = pre.attributes;
const value = attrMap.getNamedItem("test").value;
pre.textContent = `The 'test' attribute contains ${value}.
And 'foo' has ${attrMap["foo"] ? "been" : "not been"} found.`;

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
getNamedItem 1 12 1 ≤12.1 1 18 4 ≤12.1 1 1.0 4.4 1

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NamedNodeMap/getNamedItem