ValidityState

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

ИнтерфейсValidityState представляетсостояния валидности, в которых может находиться элемент при валидации ограничений. Вместе они помогают понять, по какой именно причине значение элемента не прошло валидацию.

Свойства

Если свойство возвращаетtrue, значит оно отражает причину, по которой значение не прошло валидацию. Исплючением является лишь свойствоvalid, которое возвращаетtrue, когда значение элемента соответствует всем ограничениям.

badInputТолько для чтения: Booleantrue, если пользователь ввёл значение, которое браузер не может преобразовать.
customErrorТолько для чтения: Boolean, указывающий, было ли установлено кастомное сообщение валидации путём вызова методаsetCustomValidity() с непустой строкой в аргументе.
patternMismatchТолько для чтения: Booleantrue, если значение не соответствует шаблону, указанному в атрибутеpattern.false, если значение соответствует этому шаблону. Еслиtrue, элемент соответствует CSS-псевдоклассу:invalid.
rangeOverflowТолько для чтения: Booleantrue, если значение больше максимума, заданного в атрибутеmax.false, если значение меньше или равно ему. Еслиtrue, элемент соответствует CSS-псевдоклассам:invalid и:out-of-range.
rangeUnderflowТолько для чтения: Booleantrue, если значение меньше минимума, заданного в атрибутеmin.false, если значение больше или равно ему. Еслиtrue, элемент соответствует CSS-псевдоклассам:invalid и:out-of-range.
stepMismatchТолько для чтения: Booleantrue, если значение не соответствует правилам, заданным в атрибутеstep (то есть, не делится без остатка на значение шага).false, если соответствует этим правилам. Еслиtrue, элемент соответствует CSS-псевдоклассам:invalid и:out-of-range.
tooLongТолько для чтения: Booleantrue, если значение превышает лимит, указанный в атрибутеmaxlength объектовHTMLInputElement илиHTMLTextAreaElement.false, если длина меньше или равна максимальной длине.Примечание: Данное свойство никогда не будетtrue в Gecko, потому что значению элемента не разрешается быть большеmaxlength. Еслиtrue, элемент соответствует CSS-псевдоклассам:invalid и:out-of-range.
tooShortТолько для чтения: Booleantrue, если длина значения не достигает минимума, указанного в атрибутеminlength объектовHTMLInputElement иHTMLTextAreaElement.false, если длина больше или равна ему. Еслиtrue, элемент соответствует CSS-псевдоклассам:invalid и:out-of-range.
typeMismatchТолько для чтения: Booleantrue, если значение не соответствует требуемому синтаксису (когда дляtype задано значениеemail илиurl).false, если синтаксис корректный. Еслиtrue, элемент соответствует CSS-псевдоклассу:invalid.
validТолько для чтения: Booleantrue, если элемент соответствует всем ограничениям валидации и, следовательно, считается валидным.false, если не соответствует любому ограничению. Еслиtrue, элемент соответствует CSS-псевдоклассу:valid; иначе — псевдоклассу:invalid.
valueMissingТолько для чтения: Booleantrue, если у элемента есть атрибутrequired, но сам элемент заполнен не был.false, если элемент был заполнен. Еслиtrue, элемент соответствует CSS-псевдоклассу:invalid.