Element: getAttributeNames() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.
ThegetAttributeNames() method of theElement interface returns the attribute names of the element as anArray of strings. If the element has no attributes it returns an emptyarray.
UsinggetAttributeNames() along withgetAttribute(), is a memory-efficient andperformant alternative to accessingElement.attributes.
The names returned bygetAttributeNames() arequalified attribute names, meaning that attributes with a namespace prefix have their names returned with that namespace prefix (not the actual namespace), followed by a colon, followed by the attribute name (for example,xlink:href), while any attributes which have no namespace prefix have their names returned as-is (for example,href).
In this article
Syntax
getAttributeNames()Parameters
None.
Return value
An (Array) of strings.
Examples
The following example shows how:
- For an attribute which has a namespace prefix,
getAttributeNames()returns that namespace prefix along with the attribute name. - For an attribute which has no namespace prefix,
getAttributeNames()returns just the attribute name, as-is.
It's important to understand that:
- An attribute can be present in the DOM with a namespace but lacking a namespace prefix.
- For an attribute in the DOM that has a namespace but lacks a namespace prefix,
getAttributeNames()will return just the attribute name, with no indication that the attribute is in a namespace.
The example below includes such a "namespaced but without a namespace prefix" case.
const element = document.createElement("a");// set "href" attribute with no namespace and no namespace prefixelement.setAttribute("href", "https://example.com");// set "href" attribute with namespace and also "xlink" namespace prefixelement.setAttributeNS( "http://www.w3.org/1999/xlink", "xlink:href", "https://example.com",);// set "show" attribute with namespace but no namespace prefixelement.setAttributeNS("http://www.w3.org/1999/xlink", "show", "new");// Iterate over element's attributesfor (const name of element.getAttributeNames()) { const value = element.getAttribute(name); console.log(name, value);}// logs:// href https://example.com// xlink:href https://example.com// show newSpecifications
| Specification |
|---|
| DOM> # ref-for-dom-element-getattributenames①> |