JavaScript Element removeAttributeNode() Method

What You’ll Learn

Element.removeAttributeNode() is an instance method that removes an Attr node from an element and returns that node. Learn the MDN lang workflow with getAttributeNode(), when to prefer removeAttribute(), and five try-it labs aligned with MDN.

Introduction

Most code deletes attributes with removeAttribute("lang"). The removeAttributeNode() variant takes an Attr node instead of a name. MDN: it removes the specified Attr node from the element.

Use it when you already have an Attr object—for example from getAttributeNode()—and want to inspect it before removal or keep the removed node in a variable.

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

Understanding the removeAttributeNode() Method

Calling el.removeAttributeNode(attrNode) detaches that Attr from the element and returns the removed node.

• It is an instance method on Element.
• Parameter: an Attr node that belongs to this element (MDN).
• Returns the removed Attr node (MDN).
• Throws NotFoundError if the Attr is not in this element’s list (MDN).
• Works for both namespaced and non-namespaced attributes (MDN notes).
• If the attribute has a default value, it may be immediately replaced (MDN).
• Pair with getAttributeNode() and setAttributeNode().

📝 Syntax

General form of Element.removeAttributeNode (MDN):

removeAttributeNode(attributeNode)

Parameters

Return value

Exceptions

NotFoundError — Thrown when the element’s attribute list does not contain the specified attribute node (MDN).

Common patterns

// MDN example
const d = document.getElementById("foo");
const dLang = d.getAttributeNode("lang");
const removed = d.removeAttributeNode(dLang);
// lang is now removed

// Simple delete? Prefer removeAttribute:
// d.removeAttribute("lang");

Examples Gallery

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

// Given: <div id="foo" lang="en-US" />
const d = document.getElementById("foo");
const dLang = d.getAttributeNode("lang");
d.removeAttributeNode(dLang);
// lang is now removed: <div id="foo" />

console.log(d.hasAttribute("lang")); // false

false

const el = document.getElementById("box");
const titleAttr = el.getAttributeNode("title");

const removed = el.removeAttributeNode(titleAttr);

console.log(removed.name);  // "title"
console.log(removed.value); // previous title text

title
Hello

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

// Attr-node API (two steps)
// const node = el.getAttributeNode("lang");
// el.removeAttributeNode(node);

// Simpler (MDN recommendation)
el.removeAttribute("lang");

console.log(el.hasAttribute("lang")); // false

false

const a = document.getElementById("a");
const b = document.getElementById("b");
const bLang = b.getAttributeNode("lang");

try {
  a.removeAttributeNode(bLang); // Attr belongs to b, not a
} catch (err) {
  console.log(err.name); // "NotFoundError"
}

NotFoundError

const card = document.getElementById("card");
const roleAttr = card.getAttributeNode("data-role");

if (roleAttr) {
  console.log("removing", roleAttr.name, "=", roleAttr.value);
  card.removeAttributeNode(roleAttr);
}

removing data-role = primary

🚀 Common Use Cases

• Removing attributes when you already hold an Attr from getAttributeNode().
• Archiving removed attribute name/value from the returned node.
• DOM libraries walking element.attributes NamedNodeMap entries.
• XML/SVG tooling (namespaced attrs work with this method per MDN).
• Legacy attribute-node APIs paired with setAttributeNode().
• Teaching the difference between name-based and node-based attribute removal.

📝 Notes

• Not Deprecated, Experimental, or Non-standard on MDN (Baseline Widely available, July 2015).
• Prefer removeAttribute() when you do not need the Attr node (MDN).
• Returns the removed Attr node (unlike removeAttribute).
• Throws NotFoundError if the Attr is not on this element.
• MDN: no separate removeAttributeNodeNS—this method handles namespaced attrs too.
• Related: getAttributeNode(), removeAttribute(), JavaScript hub.

💡 Best Practices