ElementInternals: checkValidity() 方法

Baseline 已廣泛支援

此功能已成熟,並可在許多裝置和瀏覽器版本上執行。自 2023 年 3 月以來,它已在各種瀏覽器中可用。

ElementInternals 介面的 checkValidity() 方法用於檢查元素是否滿足應用於它的任何 約束驗證 規則。

如果 checkValidity 返回 false,則會在元素上觸發一個可取消的 invalid 事件

語法

js
checkValidity()

引數

無。

返回值

一個布林值,如果元素滿足所有驗證約束,則為 true

異常

NotSupportedError DOMException

如果元素沒有將其 formAssociated 屬性設定為 true,則丟擲此異常。

示例

在下面的示例中,ElementInternals.setValidity() 用於指示元素不符合驗證規則。呼叫 checkValidity() 會返回 false。再次呼叫 setValidity,這次指示所有規則都被標記為 false,checkValidity() 會返回 true

js
let element = document.getElementById("join-checkbox");
element.internals_.setValidity({ valueMissing: true }, "my message");
console.log(element.internals_.checkValidity()); // false
element.internals_.setValidity({});
console.log(element.internals_.checkValidity()); // true

規範

規範
HTML
# dom-elementinternals-checkvalidity

瀏覽器相容性