База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLInputElement.valueAsNumber — числовата стойност на поле за въвеждане

Четете и задавайте числовата стойност на поле за въвеждане. Разпознавайте NaN и имайте предвид, че преобразуването зависи от типа на полето.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

input.valueAsNumber
input.valueAsNumber = number

HTMLInputElement.valueAsNumber прочита стойността на поле за въвеждане като число, докато value съдържа текст. Това е API на браузъра, дефиниран в HTML Standard, а не функция на ECMAScript.

Празно поле от тип number, неуспешно преобразуване или неподдържан тип връща NaN. Проверявайте резултата с Number.isNaN(). Задаването на NaN на свойството valueAsNumber изчиства поле от тип number, както е показано в примера. Типът range също поддържа valueAsNumber, но правилата му за нормализиране на стойността заменят празния низ с числова стойност по подразбиране. Задаването на безкрайност предизвиква TypeError, а задаването на крайно число към неподдържан тип предизвиква InvalidStateError.

Преобразуването зависи от type: типовете за дата и час имат собствени числови представяния. Числовият резултат не гарантира спазване на min, max или step; проверявайте валидирането отделно.

Примерът използва поле number, което не е добавено към документа. Необходим е DOM на браузър; само Node 24 не доказва поддръжка.

Примери

const input = document.createElement('input');
input.type = 'number';
input.step = 'any';
input.value = '12.5';
console.log(input.valueAsNumber + 2);

input.valueAsNumber = 7;
console.log(JSON.stringify(input.value));

input.valueAsNumber = NaN;
console.log(JSON.stringify(input.value));
console.log(Number.isNaN(input.valueAsNumber));

Резултат

14.5
"7"
""
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници