HTMLAnchorElement: relList property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The HTMLAnchorElement.relList read-only property reflects the rel attribute. It is a live DOMTokenList containing the set of link types indicating the relationship between the resource represented by the <a> element and the current document.

The property itself is read-only, meaning you can't substitute the DOMTokenList with another one, but its contents can still be changed.

Value

A live DOMTokenList of strings.

Examples

js
const anchors = document.getElementsByTagName("a");
for (const anchor of anchors) {
  const list = anchor.relList;
  console.log(
    `New anchor node found with ${list.length} link types in relList.`,
  );
  list.forEach((relValue) => {
    console.log(relValue);
  });
}

Specifications

Specification
HTML Standard
# dom-a-rellist

Browser compatibility

BCD tables only load in the browser

See also