Skip to Main Content
JavaScript: The Definitive Guide, Fourth Edition
book

JavaScript: The Definitive Guide, Fourth Edition

by David Flanagan
November 2001
Intermediate to advanced content levelIntermediate to advanced
936 pages
68h 43m
English
O'Reilly Media, Inc.
Content preview from JavaScript: The Definitive Guide, Fourth Edition

Name

Element.setAttributeNode( ) — add a new Attr node to an Element

Availability

DOM Level 1 Core

Synopsis

Attr setAttributeNode(Attr newAttr)
    throws DOMException;

Arguments

newAttr

The Attr node that represents the attribute to be added or whose value is to be modified.

Returns

The Attr node that was replaced by newAttr, or null if no attribute was replaced.

Throws

This method may throw a DOMException with a code of the following values:

INUSE_ATTRIBUTE_ERR

newAttr is already a member of the attribute set of some other Element node.

NO_MODIFICATION_ALLOWED_ERR

The Element node is read-only and does not allow modifications to its attributes.

WRONG_DOCUMENT_ERR

newAttr has a different ownerDocument property than the Element on which it is being set.

Description

This method adds a new Attr node to the set of attributes of an Element node. If an attribute with the same name already exists for the Element, newAttr replaces that attribute, and the replaced Attr node is returned. If no such attribute already exists, this method defines a new attribute for the Element.

It is usually easier to use setAttribute( ) instead of setAttributeNode( ). However, you should use setAttributeNode( ) when you need to define an attribute whose value contains an entity reference for an XML document.

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Start your free trial

You might also like

JavaScript: A Beginner's Guide, Fourth Edition, 4th Edition

JavaScript: A Beginner's Guide, Fourth Edition, 4th Edition

John Pollock
Coding with JavaScript For Dummies

Coding with JavaScript For Dummies

Chris Minnick, Eva Holland

Publisher Resources

ISBN: 0596000480Supplemental ContentCatalog PageErrata