JavaScript: The Definitive Guide, Fourth Edition

Name

Element.setAttributeNodeNS( ) — add a namespace Attr node to an Element

Availability

DOM Level 2 Core

Synopsis

Attr setAttributeNodeNS(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 throws exceptions for the same reasons as setAttributeNode( ). It may also throw a DOMException with a code of NOT_SUPPORTED_ERR to signal that the method is not implemented because the current implementation does not support XML documents and namespaces.

Description

This method works just like setAttributeNode( ), except that it is designed for use with Attr nodes that represent attributes specified by namespace and name.

This method is useful only with XML documents that use namespaces. It may be unimplemented (i.e., throw a NOT_SUPPORTED_ERR) on browsers that do not support XML documents.

See Also

Attr, Element.setAttributeNS( ), Element.setAttributeNode( )