← 返回首页
HTMLSelectElement: setCustomValidity() method - Web APIs | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Web
  2. Web APIs
  3. HTMLSelectElement
  4. setCustomValidity()
Theme
  • OS default
  • Light
  • Dark
English (US)
Remember language Learn more

HTMLSelectElement: setCustomValidity() method

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 HTMLSelectElement.setCustomValidity() method sets the custom validity message for the selection element to the specified message. Use the empty string to indicate that the element does not have a custom validity error.

In this article

Syntax

js
setCustomValidity(string)

Parameters

string

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

Return value

None (undefined).

Specifications

Specification
HTML
# dom-cva-setcustomvalidity-dev

Browser compatibility

Enable JavaScript to view this browser compatibility table.

See also

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on Apr 10, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. HTML DOM API
  2. HTMLSelectElement
  3. Instance properties
    1. autocomplete
    2. disabled
    3. form
    4. labels
    5. length
    6. multiple
    7. name
    8. options
    9. required
    10. selectedIndex
    11. selectedOptions
    12. size
    13. type
    14. validationMessage
    15. validity
    16. value
    17. willValidate
  4. Instance methods
    1. add()
    2. checkValidity()
    3. item()
    4. namedItem()
    5. remove()
    6. reportValidity()
    7. setCustomValidity()
    8. showPicker()
  5. Inheritance
    1. HTMLElement
    2. Element
    3. Node
    4. EventTarget
  6. Related pages for HTML DOM
    1. BeforeUnloadEvent
    2. DOMStringMap
    3. ErrorEvent
    4. HTMLAnchorElement
    5. HTMLAreaElement
    6. HTMLAudioElement
    7. HTMLBRElement
    8. HTMLBaseElement
    9. HTMLBodyElement
    10. HTMLButtonElement
    11. HTMLCanvasElement
    12. HTMLDListElement
    13. HTMLDataElement
    14. HTMLDataListElement
    15. HTMLDialogElement
    16. HTMLDivElement
    17. HTMLDocument
    18. HTMLElement
    19. HTMLEmbedElement
    20. HTMLFieldSetElement
    21. HTMLFormControlsCollection
    22. HTMLFormElement
    23. HTMLFrameSetElement
    24. HTMLGeolocationElement
    25. HTMLHRElement
    26. HTMLHeadElement
    27. HTMLHeadingElement
    28. HTMLHtmlElement
    29. HTMLIFrameElement
    30. HTMLImageElement
    31. HTMLInputElement
    32. HTMLLIElement
    33. HTMLLabelElement
    34. HTMLLegendElement
    35. HTMLLinkElement
    36. HTMLMapElement
    37. HTMLMediaElement
    38. HTMLMenuElement
    39. HTMLMetaElement
    40. HTMLMeterElement
    41. HTMLModElement
    42. HTMLOListElement
    43. HTMLObjectElement
    44. HTMLOptGroupElement
    45. HTMLOptionElement
    46. HTMLOptionsCollection
    47. HTMLOutputElement
    48. HTMLParagraphElement
    49. HTMLPictureElement
    50. HTMLPreElement
    51. HTMLProgressElement
    52. HTMLQuoteElement
    53. HTMLScriptElement
    54. HTMLSourceElement
    55. HTMLSpanElement
    56. HTMLStyleElement
    57. HTMLTableCaptionElement
    58. HTMLTableCellElement
    59. HTMLTableColElement
    60. HTMLTableElement
    61. HTMLTableRowElement
    62. HTMLTableSectionElement
    63. HTMLTemplateElement
    64. HTMLTextAreaElement
    65. HTMLTimeElement
    66. HTMLTitleElement
    67. HTMLTrackElement
    68. HTMLUListElement
    69. HTMLUnknownElement
    70. HTMLVideoElement
    71. HashChangeEvent
    72. History
    73. ImageData
    74. Location
    75. MessageChannel
    76. MessageEvent
    77. MessagePort
    78. Navigator
    79. PageRevealEvent
    80. PageSwapEvent
    81. PageTransitionEvent
    82. Plugin
    83. PluginArray
    84. PromiseRejectionEvent
    85. RadioNodeList
    86. TimeRanges
    87. UserActivation
    88. ValidityState
    89. Window
    90. WorkletGlobalScope
  7. Guides
    1. Using microtasks in JavaScript with queueMicrotask()
    2. In depth: Microtasks and the JavaScript runtime environment

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.