HTMLFormElement: checkValidity() 方法

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

checkValidity() 方法屬於 HTMLFormElement 介面，它返回一個布林值，指示所有關聯的控制元件是否滿足應用於它們的任何約束驗證規則。該方法還會對每個無效的元素觸發一個 invalid 事件，但不會在表單元素本身上觸發。由於 checkValidity() 沒有預設的瀏覽器行為，取消此 invalid 事件無效。

注意： :valid 和 :invalid CSS 偽類應用於 <form> 元素是基於其擁有的表單控制元件的有效性，而不是 <form> 元素本身的有效性。

語法

checkValidity()

引數

無。

返回值

如果關聯控制元件的值沒有任何有效性問題，則返回 true；否則返回 false。

示例

在下面的示例中，呼叫 checkValidity() 將返回 true 或 false。

const element = document.getElementById("myForm");
console.log(element.checkValidity());

規範

規範
HTML # dom-form-checkvalidity-dev

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ⁨2025年4月10日⁩，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤