Element.setAttributeNS(options)

Note:

The content in this help topic pertains to SuiteScript 2.0.

Method Description

Adds a new attribute with the specified name and namespace URI. If an attribute with the same name and namespace URI is already present in the element, its value is changed to the value specified in method argument.

If an attribute with the specified name already exists, the value of the attribute is changed to the value of the value parameter. If the attribute node replaces an existing attribute node, the method returns the new xml.Attr object.

Important:

This method is not supported on Internet Explorer.

Returns

void

Supported Script Types

Client and server scripts

For more information, see SuiteScript 2.x Script Types.

Governance

None

Module

N/xml Module

Since

2015.2

Parameters
Note:

The options parameter is a JavaScript object.

Parameter

Type

Required / Optional

Description

options.namespaceURI

string

required

Namespace URI of the attribute node to add.

options.qualifiedName

string

required

Fully qualified attribute name to add.

options.value

string

required

String value of the attribute to add.

Errors

Error Code

Message

Thrown If

SSS_XML_DOM_EXCEPTION

INVALID_CHARACTER_ERR: An invalid or illegal XML character is specified.

Attribute node with the specified value cannot be added.

Syntax
Important:

The following code sample shows the syntax for this member. It is not a functional example. For a complete script example, see N/xml Module Script Samples.

          //Add additional code 
...
elem[0].setAttributeNS({
    namespaceURI : '*',
    qualifiedName : 'lang',
    value : 'fr'
});
...
//Add additional code 

        

Related Topics

xml.Element
N/xml Module
SuiteScript 2.x Modules
SuiteScript 2.x

General Notices