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 = numberHTMLInputElement.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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.