Name
NamedNodeMap.setNamedItem( ) — add a node to or replace a node in a NamedNodeMap
Availability
DOM Level 1 Core
Synopsis
Node setNamedItem(Node arg
)
throws DOMException;
Arguments
-
arg
The node to be added to the NamedNodeMap.
Returns
The node that was replaced, or null
if no node was
replaced.
Throws
This method may throw a DOMException with one of the following
code
values:
-
HIERARCHY_REQUEST_ERR
arg
is a node of a type that is not suitable for this NamedNodeMap (e.g., is not an Attr node).-
INUSE_ATTRIBUTE_ERR
arg
is an Attr node that is already associated with an element.-
NO_MODIFICATION_ALLOWED_ERR
The NamedNodeMap is read-only.
-
WRONG_DOCUMENT_ERR
arg
has a differentownerDocument
than the document from which the NamedNodeMap was created.
Description
setNamedItem( )
adds the specified node to a
NamedNodeMap and allows it to be looked up using the value of the
node’s nodeName
property. If the
NamedNodeMap already contains a node with that name, that node is
replaced and becomes the return value of the method.
See Also
Get JavaScript: The Definitive Guide, Fourth Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.