ElementInternals: checkValidity() メソッド

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

checkValidity()ElementInternals インタフェイスのメソッドで、要素が適用された制約検証のルールを満たしているかどうかをチェックします。

もし checkValidityfalse を返したら、キャンセル可能な 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 }, "メッセージ");
console.log(element.internals_.checkValidity()); // false
element.internals_.setValidity({});
console.log(element.internals_.checkValidity()); // true

仕様書

Specification
HTML Standard
# dom-elementinternals-checkvalidity

ブラウザーの互換性

BCD tables only load in the browser