JavaScript Element namespaceURI Property

What You’ll Learn

Element.namespaceURI is a read-only instance property that returns the element’s namespace URI as a string, or null when there is no namespace. Learn the HTML and SVG URIs, how createElementNS sets it, and how to pair it with localName—with five examples and try-it labs.

Introduction

Namespaces keep element names from colliding across vocabularies. HTML, SVG, and MathML can all use short names like a or title—namespaceURI tells you which vocabulary an element belongs to.

In a normal HTML page, almost every HTML tag reports the XHTML namespace URI. SVG elements report the SVG namespace. You create namespaced nodes with document.createElementNS().

const box = document.getElementById("box");
console.log(box.namespaceURI);
// "http://www.w3.org/1999/xhtml"

Understanding the Property

MDN: the read-only namespaceURI property returns the namespace URI of the element, or null if the element is not in a namespace.

• Read-only — fixed when the node is created.
• String or null — a URI string, or no namespace.
• HTML default — HTML elements use http://www.w3.org/1999/xhtml.
• Baseline — widely available since July 2015 (MDN).

📝 Syntax

namespaceURI

Value

A string containing the namespace URI, or null when the element has no namespace. The value is frozen at creation—it is not recomputed from later xmlns lookups.

📋 MDN Check Example Shape

MDN pairs localName and namespaceURI to identify a specific element type (XUL example shown conceptually):

if (
  element.localName === "browser" &&
  element.namespaceURI ===
    "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
) {
  // this is a XUL browser
}

In everyday web pages, the same idea applies to SVG: localName === "circle" and namespaceURI === "http://www.w3.org/2000/svg".

Related learning: localName, prefix, and createElementNS().

Examples Gallery

Examples follow MDN Element: namespaceURI. Labs use HTML and SVG nodes so you can compare namespaces in the browser.

const box = document.getElementById("box");
console.log(box.namespaceURI);

http://www.w3.org/1999/xhtml

const circle = document.createElementNS(
  "http://www.w3.org/2000/svg",
  "circle"
);
console.log(circle.namespaceURI);
console.log(circle.localName);

http://www.w3.org/2000/svg
circle

const SVG_NS = "http://www.w3.org/2000/svg";
const el = document.createElementNS(SVG_NS, "circle");
const isSvgCircle =
  el.localName === "circle" && el.namespaceURI === SVG_NS;
console.log(isSvgCircle);

true

const htmlA = document.createElement("a");
const svgA = document.createElementNS(
  "http://www.w3.org/2000/svg",
  "a"
);
console.log(htmlA.namespaceURI);
console.log(svgA.namespaceURI);
console.log(htmlA.localName === svgA.localName);

http://www.w3.org/1999/xhtml
http://www.w3.org/2000/svg
true

console.log({
  supported: "namespaceURI" in Element.prototype,
  returns: "string or null",
  htmlNS: "http://www.w3.org/1999/xhtml",
  svgNS: "http://www.w3.org/2000/svg",
  status: "Baseline Widely available (MDN)"
});

{
  "supported": true,
  "returns": "string or null",
  "htmlNS": "http://www.w3.org/1999/xhtml",
  "svgNS": "http://www.w3.org/2000/svg",
  "status": "Baseline Widely available (MDN)"
}

🚀 Common Use Cases

• Confirming an HTML element uses the XHTML namespace.
• Detecting SVG nodes before using SVG-specific APIs.
• Pairing with localName for precise element identity checks.
• Debugging mixed HTML/SVG documents and unexpected createElement results.
• Validating nodes created with createElementNS.

🔧 How It Works

📝 Notes

• Not Deprecated, Experimental, or Non-standard on MDN (Baseline Widely available).
• Read-only and frozen at creation—not a live xmlns lookup.
• The DOM does not enforce namespace validation for you; apps decide what is valid.
• Related: localName, prefix, createElementNS(), nextElementSibling, JavaScript hub.

💡 Best Practices