JavaScript Element removeAttributeNS() Method

What You’ll Learn

Element.removeAttributeNS() is an instance method that removes a namespaced attribute from an element. Learn MDN’s specialAlign example, SVG xlink:href removal, when to prefer removeAttribute() for plain HTML, pairing with hasAttributeNS(), and five try-it labs aligned with MDN.

Introduction

Most HTML attributes are removed with removeAttribute("class"). When an attribute belongs to a namespace — common in SVG and XML — you need removeAttributeNS(namespace, attrName) instead.

MDN: if you work with HTML documents and do not need to specify the attribute as part of a namespace, use removeAttribute(). Reach for removeAttributeNS() when namespace URIs matter.

This page is part of JavaScript Element. Related: removeAttribute(), hasAttributeNS().

Understanding the removeAttributeNS() Method

Calling el.removeAttributeNS(namespace, attrName) removes the namespaced attribute that matches the namespace URI and attribute name.

• It is an instance method on Element.
• namespace — a string with the attribute namespace URI (MDN).
• attrName — a string naming the attribute to remove (MDN).
• Returns undefined (MDN).
• Does not throw when the attribute is missing (same pattern as removeAttribute()).
• For plain HTML attributes, prefer removeAttribute() (MDN).
• Pair with hasAttributeNS() to verify removal.

📝 Syntax

General form of Element.removeAttributeNS (MDN):

removeAttributeNS(namespace, attrName)

Parameters

namespace — a string specifying the namespace of the attribute (MDN).

attrName — a string that names the attribute to be removed from the element (MDN).

Return value

None (undefined) (MDN).

Common patterns

const XLINK_NS = "http://www.w3.org/1999/xlink";
const SPECIAL_NS = "http://www.mozilla.org/ns/specialspace";

// MDN example
const d = document.getElementById("div1");
d.removeAttributeNS(SPECIAL_NS, "specialAlign");

// SVG xlink:href removal
const anchor = document.querySelector("svg a");
anchor.removeAttributeNS(XLINK_NS, "href");

// Plain HTML? Prefer removeAttribute:
// el.removeAttribute("class");

Examples Gallery

Examples follow MDN Element.removeAttributeNS() patterns. Use View Output or Try It Yourself for each case.

// Given: <div id="div1" xmlns:special="http://www.mozilla.org/ns/specialspace"
//   special:specialAlign="utterleft" width="200px" />
const SPECIAL_NS = "http://www.mozilla.org/ns/specialspace";
const d = document.getElementById("div1");

d.removeAttributeNS(SPECIAL_NS, "specialAlign");
// specialAlign is now removed

false

const XLINK_NS = "http://www.w3.org/1999/xlink";
const anchor = document.querySelector("svg a");

anchor.removeAttributeNS(XLINK_NS, "href");

console.log(anchor.hasAttributeNS(XLINK_NS, "href"));

false

const el = document.getElementById("box");

// Namespaced API (only when you need a namespace URI)
// el.removeAttributeNS(SOME_NS, "attrName");

// Simpler for plain HTML (MDN recommendation)
el.removeAttribute("data-role");

console.log(el.hasAttribute("data-role"));

false

const XLINK_NS = "http://www.w3.org/1999/xlink";
const anchor = document.querySelector("svg a");

const before = anchor.hasAttributeNS(XLINK_NS, "href");
anchor.removeAttributeNS(XLINK_NS, "href");
const after = anchor.hasAttributeNS(XLINK_NS, "href");

console.log(before, after);

true false

const XLINK_NS = "http://www.w3.org/1999/xlink";
const anchor = document.querySelector("svg a");

// Already removed or never present — still safe
anchor.removeAttributeNS(XLINK_NS, "href");
anchor.removeAttributeNS(XLINK_NS, "href");

console.log("no error");

no error

🚀 Common Use Cases

• Removing SVG xlink:href from icon and chart elements.
• Stripping custom XML namespace attributes in mixed documents.
• DOM libraries paired with setAttributeNS() for round-trip edits.
• Cleaning namespaced hooks before cloning or serializing SVG nodes.
• Teaching when namespace URIs matter vs plain removeAttribute().
• Verifying removal with hasAttributeNS() in tests and tooling.

📝 Notes

• Not Deprecated, Experimental, or Non-standard on MDN (Baseline Widely available, July 2015).
• For plain HTML attributes, MDN recommends removeAttribute() instead.
• Uses namespace URI + attrName (MDN parameter name).
• Returns undefined — no removed value is returned.
• Does not throw when the attribute is missing (safe no-op).
• Pair with hasAttributeNS() to verify removal.
• Related: removeAttribute(), hasAttributeNS(), getAttributeNS(), JavaScript hub.

💡 Best Practices