JavaScript NamedNodeMap getNamedItemNS() Method

What You’ll Learn

The getNamedItemNS() method of a NamedNodeMap returns a namespaced Attr node when you pass a namespace URI and localName. Learn the MDN XML example, why the URI is not the prefix, and how it compares with getNamedItem() and getAttributeNS()—with five examples and try-it labs.

Introduction

HTML attributes like id and class usually have no namespace. XML and SVG often do—for example ob:one="test" with xmlns:ob="http://www.example.com/ob".

getNamedItem("ob:one") is not the right tool for that namespaced attribute. Instead, call getNamedItemNS("http://www.example.com/ob", "one") on element.attributes.

Understanding the getNamedItemNS() Method

An instance method on NamedNodeMap that looks up an attribute by namespace URI and local name.

• namespace — string URI of the attribute’s namespace (not the prefix).
• localName — string local part of the attribute name (without prefix).
• Returns — an Attr node, or null if not found.
• Common source — element.attributes on XML/SVG nodes.
• Pair with — DOMParser for in-memory XML (MDN example).
• Baseline Widely available on MDN (since July 2015).

📝 Syntax

Call the method on a NamedNodeMap (usually from element.attributes):

namedNodeMap.getNamedItemNS(namespace, localName)

Parameters

• namespace — namespace URI string (use null for attributes with no namespace in some APIs; here pass the actual URI from xmlns).
• localName — the attribute’s local name without prefix.

Return value

An Attr for the namespace and local name, or null if none matches.

Typical pattern (MDN idea)

const parser = new DOMParser();
const xmlString =
  '<warning ob:one="test" xmlns:ob="http://www.example.com/ob">Beware!</warning>';
const doc = parser.parseFromString(xmlString, "application/xml");

const warning = doc.querySelector("warning");
const value = warning.attributes.getNamedItemNS(
  "http://www.example.com/ob",
  "one",
).value;

console.log(value); // "test"

⚖️ getNamedItemNS() vs Related Ideas

Examples Gallery

Examples follow MDN NamedNodeMap.getNamedItemNS. Labs use DOMParser and namespaced XML attributes.

const parser = new DOMParser();
const xmlString =
  '<warning ob:one="test" xmlns:ob="http://www.example.com/ob">Beware!</warning>';
const doc = parser.parseFromString(xmlString, "application/xml");
const warning = doc.querySelector("warning");

const value = warning.attributes.getNamedItemNS(
  "http://www.example.com/ob",
  "one",
).value;

console.log(`The 'ob:one' attribute contains: ${value}.`);

The 'ob:one' attribute contains: test.

const doc = new DOMParser().parseFromString(
  '<item app:id="42" xmlns:app="https://example.com/app"/>',
  "application/xml",
);
const item = doc.documentElement;
const attr = item.attributes.getNamedItemNS("https://example.com/app", "id");

console.log({
  localName: attr.localName,
  value: attr.value,
  namespaceURI: attr.namespaceURI,
});

{ "localName": "id", "value": "42", "namespaceURI": "https://example.com/app" }

const doc = new DOMParser().parseFromString(
  '<warning ob:one="test" xmlns:ob="http://www.example.com/ob"/>',
  "application/xml",
);
const warning = doc.documentElement;

const correct = warning.attributes.getNamedItemNS("http://www.example.com/ob", "one");
const wrongPrefix = warning.attributes.getNamedItemNS("ob", "one");

console.log(correct !== null, wrongPrefix === null); // true true

true true

const doc = new DOMParser().parseFromString(
  '<warning ob:one="test" xmlns:ob="http://www.example.com/ob"/>',
  "application/xml",
);
const map = doc.documentElement.attributes;

const viaNS = map.getNamedItemNS("http://www.example.com/ob", "one");
const viaName = map.getNamedItem("ob:one"); // may work in some parsers

console.log(viaNS?.value, viaName?.value);

test test

const doc = new DOMParser().parseFromString(
  '<warning ob:one="test" xmlns:ob="http://www.example.com/ob"/>',
  "application/xml",
);
const warning = doc.documentElement;
const uri = "http://www.example.com/ob";

const attr = warning.attributes.getNamedItemNS(uri, "one");
const str = warning.getAttributeNS(uri, "one");

console.log(typeof attr, typeof str, attr.value === str);

object string true

🚀 Common Use Cases

• Read namespaced XML attributes from DOMParser documents.
• Inspect SVG or MathML attribute nodes with namespace metadata.
• Interop with code that walks element.attributes NamedNodeMap.
• Teach the difference between prefix, localName, and namespace URI.
• Debug XML configs where attributes use xmlns: declarations.

🔧 How It Works

📝 Notes

• MDN: Baseline Widely available (since July 2015) — no Deprecated / Experimental / Non-standard banner.
• First parameter is namespace URI, not xmlns prefix.
• Second parameter is localName without prefix.
• Most plain HTML attributes do not need getNamedItemNS.
• Related learning: getNamedItem(), getAttributeNS(), Element.attributes.

💡 Best Practices