Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLInputElement.valueAsNumber — číselná hodnota vstupního pole

Čtěte a zapisujte číselnou hodnotu vstupního pole. Rozpoznávejte NaN a mějte na paměti, že převod závisí na typu pole.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

input.valueAsNumber
input.valueAsNumber = number

HTMLInputElement.valueAsNumber čte hodnotu vstupního pole jako číslo, zatímco value obsahuje text. Jde o API prohlížeče definované standardem HTML Standard, nikoli o funkci ECMAScriptu.

Prázdné pole typu number, neúspěšný převod nebo nepodporovaný typ vrací NaN. Výsledek ověřte pomocí Number.isNaN(). Přiřazení NaN do valueAsNumber vyprázdní pole typu number, jak ukazuje příklad. Typ range také podporuje valueAsNumber, ale jeho pravidla pro úpravu hodnoty nahradí prázdný řetězec výchozí číselnou hodnotou. Přiřazení nekonečna vyvolá TypeError a přiřazení konečného čísla nepodporovanému typu vyvolá InvalidStateError.

Převod závisí na type: typy data a času mají vlastní číselné reprezentace. Číselný výsledek nezaručuje dodržení min, max ani step; validaci kontrolujte zvlášť.

Příklad používá pole number, které není připojeno k dokumentu. Vyžaduje DOM prohlížeče; samotný Node 24 podporu nedokládá.

Příklady

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));

Výsledek

14.5
"7"
""
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje