ElementInternals: ariaErrorMessageElements property

Baseline 2025

Newly available

Since ⁨April 2025⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

The ariaErrorMessageElements property of the ElementInternals interface is an array containing the element (or elements) that provide an error message for the element it is applied to.

The aria-errormessage topic contains additional information about how the attribute and property should be used.

Value

An array of subclasses of HTMLElement. The inner text of these elements can be joined with spaces to get the error message.

When read, the returned array is a static and read-only. When written, the assigned array is copied: subsequent changes to the array do not affect the value of the property.

The property is a flexible alternative to using the aria-errormessage attribute to set the error message for an element. Unlike aria-errormessage, the elements assigned to this property do not have to have an id attribute.

The property reflects the element's aria-errormessage attribute when it is defined, but only for listed reference id values that match valid in-scope elements. If the property is set, then the corresponding attribute is cleared. For more information about reflected element references and scope see Reflected element references in the Reflected attributes guide.

Examples

The examples in the following documents are relevant:

Element.ariaErrorMessageElements is the DOM equivalent of this property. It is used in the same way, but within the DOM instead of a shadow DOM and/or custom element.