ElementInternals: checkValidity() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.

Phương thức checkValidity() của giao diện ElementInternals kiểm tra xem phần tử có đáp ứng bất kỳ quy tắc xác thực ràng buộc nào được áp dụng cho nó hay không.

Nếu checkValidity trả về false, một sự kiện invalid có thể hủy bỏ sẽ được kích hoạt trên phần tử.

Cú pháp

js
checkValidity()

Tham số

Không có.

Giá trị trả về

Một giá trị boolean, true nếu phần tử đáp ứng tất cả các ràng buộc xác thực.

Ngoại lệ

NotSupportedError DOMException

Được ném ra nếu phần tử không có thuộc tính formAssociated được đặt thành true.

Ví dụ

Trong ví dụ sau, ElementInternals.setValidity() được sử dụng để chỉ ra rằng phần tử không đáp ứng các quy tắc xác thực. Gọi checkValidity() trả về false. Sau khi gọi setValidity lần nữa, lần này chỉ ra rằng tất cả các quy tắc đều được đánh dấu là false, checkValidity() trả về 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

Thông số kỹ thuật

Thông số kỹ thuật
HTML
# dom-elementinternals-checkvalidity

Tương thích trình duyệt