NamedNodeMap

The NamedNodeMap interface represents a collection of Attr objects. Objects inside a NamedNodeMap are not in any particular order, unlike NodeList, although they may be accessed by an index as in an array.

A NamedNodeMap object is live and will thus be auto-updated if changes are made to its contents internally or elsewhere.

Although called NamedNodeMap, this interface doesn't deal with Node objects but with Attr objects, which were originally a specialized class of Node, and still are in some implementations.

Properties

This interface doesn't inherit any property.

NamedNodeMap.length Read only
Returns the amount of objects in the map.

Methods

This interface doesn't inherit any method.

NamedNodeMap.getNamedItem()
Returns a Attr, corresponding to the given name.
NamedNodeMap.setNamedItem()
Replaces, or adds, the Attr identified in the map by the given name.
NamedNodeMap.removeNamedItem()
Removes the Attr identified by the given map.
NamedNodeMap.item()
Returns the Attr at the given index, or null if the index is higher or equal to the number of nodes.
NamedNodeMap.getNamedItemNS()
Returns a Attr identified by a namespace and related local name.
NamedNodeMap.setNamedItemNS()
Replaces, or adds, the Attr identified in the map by the given namespace and related local name.
NamedNodeMap.removeNamedItemNS()
Removes the Attr identified by the given namespace and related local name.

Specifications

Specification Status Comment
DOM
The definition of 'NamedNodeMap' in that specification.
Living Standard Deals with Attr instead of Node
Document Object Model (DOM) Level 3 Core Specification
The definition of 'NamedNodeMap' in that specification.
Recommendation No change from Document Object Model (DOM) Level 2 Core Specification
Document Object Model (DOM) Level 2 Core Specification
The definition of 'NamedNodeMap' in that specification.
Recommendation Added getNamedItemNS(), setNamedItemNS() and removeNamedItemNS()
Document Object Model (DOM) Level 1 Specification
The definition of 'NamedNodeMap' in that specification.
Recommendation Initial definition

Browser compatibility

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
Deals with Attr rather than Node ? ? 22 (22)[1] ? ? ?
Feature Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
Deals with Attr rather than Node ? ? 22.0 (22)[1] ? ? ?

[1] In Gecko 22 this interface was named mozNamedAttrMap. In Gecko 34 it was named back to NamedNodeMap.

See also

Document Tags and Contributors

 Last updated by: abbycar,