Firefox Tomorrow

web api instance method

HTMLButtonElement: setCustomValidity() method

View on MDN ↗

The setCustomValidity() method of the HTMLButtonElement interface sets the custom validity message for the <button> element. Use the empty string to indicate that the element does not have a custom validity error.

Syntax

setCustomValidity(string)

Parameters

  • string
    • : The string containing the error message. The empty string removes any custom validity errors.

Return value

None (undefined).

Examples

const errorButton = document.getElementById("checkErrors");
const errors = issuesToReport();
if (errors) {
  errorButton.setCustomValidity("There is an error");
} else {
  errorButton.setCustomValidity("");
}

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also