JavaScript Node lookupNamespaceURI() Method

What You’ll Learn

The Node.lookupNamespaceURI() method turns a prefix into a namespace URI on a node. Learn default-namespace lookups with null, the special xml / xmlns prefixes, and how this pairs with isDefaultNamespace().

Introduction

In XML-style markup, a prefix (like xlink: or svg:) is a short label bound to a long namespace URI. The browser (and XPath) need that URI to know which vocabulary a name belongs to.

lookupNamespaceURI(prefix) asks a node: “What URI is bound to this prefix here?” Pass null (or "") to read the default namespace—the one for unprefixed names.

Understanding lookupNamespaceURI()

MDN: given a prefix, return the associated namespace URI on that node, or null if none is found. Nodes can also be passed as namespace resolvers to XPath createExpression / evaluate.

• Found — returns the URI string for that prefix.
• Not found — returns null.
• Default — null or "" means the default namespace.
• Built-ins — "xml" and "xmlns" always map to fixed URIs.

📝 Syntax

const uri = node.lookupNamespaceURI(prefix);

Parameters

• prefix — The prefix to look up. Empty string is equivalent to null (default namespace). Required in the signature, but may be null.

Return value

A string containing the namespace URI for that prefix, or null if there is none.

📋 Return Value Rules (MDN)

🌐 Common Namespace URIs

⚠️ HTML Documents vs Namespaces

MDN’s example note: in an HTML document, most xmlns: attributes are ignored (except xmlns:xlink). Firefox may report null for element namespaces, while Chrome and Safari often set HTML, SVG, and MathML defaults.

For learning and reliable tests, create nodes with createElementNS, or run scripts in a standalone SVG document as MDN suggests.

Examples Gallery

Examples follow MDN Node.lookupNamespaceURI() ideas, using createElementNS for clearer results. Use View Output or Try It Yourself.

const SVG_NS = "http://www.w3.org/2000/svg";
const svg = document.createElementNS(SVG_NS, "svg");

console.log(svg.lookupNamespaceURI(null)); // SVG_NS
console.log(svg.lookupNamespaceURI(""));   // same as null
console.log(svg.namespaceURI);             // SVG_NS

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

const el = document.createElement("div");

console.log(el.lookupNamespaceURI("xml"));
// http://www.w3.org/XML/1998/namespace

console.log(el.lookupNamespaceURI("xmlns"));
// http://www.w3.org/2000/xmlns/

http://www.w3.org/XML/1998/namespace
http://www.w3.org/2000/xmlns/

const SVG_NS = "http://www.w3.org/2000/svg";
const XLINK_NS = "http://www.w3.org/1999/xlink";
const svg = document.createElementNS(SVG_NS, "svg");
svg.setAttributeNS("http://www.w3.org/2000/xmlns/", "xmlns:xlink", XLINK_NS);

console.log(svg.lookupNamespaceURI("xlink")); // XLINK_NS
console.log(svg.lookupNamespaceURI(null));    // SVG_NS

http://www.w3.org/1999/xlink
http://www.w3.org/2000/svg

const SVG_NS = "http://www.w3.org/2000/svg";
const svg = document.createElementNS(SVG_NS, "svg");

console.log(svg.lookupNamespaceURI("svg"));   // null (no "svg" prefix declared)
console.log(svg.lookupNamespaceURI("nope"));  // null
console.log(String(svg.lookupNamespaceURI("nope")));

null
null
null

const SVG_NS = "http://www.w3.org/2000/svg";
const HTML_NS = "http://www.w3.org/1999/xhtml";
const svg = document.createElementNS(SVG_NS, "circle");

const defaultUri = svg.lookupNamespaceURI(null);
console.log(defaultUri);                         // SVG_NS
console.log(svg.isDefaultNamespace(SVG_NS));     // true
console.log(defaultUri === SVG_NS);              // true
console.log(svg.isDefaultNamespace(HTML_NS));    // false

http://www.w3.org/2000/svg
true
true
false

🚀 Common Use Cases

• Reading a node’s default namespace URI for SVG, MathML, or XML tooling.
• Resolving prefixes such as xlink before reading namespaced attributes.
• Acting as a namespace resolver for XPath createExpression / evaluate.
• Teaching how default namespaces relate to isDefaultNamespace().
• Debugging mixed documents when prefixes and defaults confuse markup.

🔧 How It Works

📝 Notes

• Baseline Widely available (MDN, since July 2015).
• Not Deprecated, Experimental, or Non-standard — no status banner required.
• HTML documents can disagree across browsers; prefer createElementNS for demos.
• Related: lookupPrefix(), isDefaultNamespace(), isSameNode(), getRootNode(), ownerDocument, JavaScript hub.

💡 Best Practices