CKTIS / JavaScript
isNaN() — проверка за NaN след преобразуване
Глобалната функция isNaN(value) първо преобразува аргумента си до Number, а след това проверява дали резултатът е NaN. За разлика от Number.isNaN(), тя може да върне true и за низове или undefined, затова не е общ тест за валидно число.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
isNaN(value)isNaN(value) е глобална функция на ECMAScript, а не API на браузъра. Тя прилага операцията ToNumber към аргумента си и връща true, ако резултатът е NaN; в противен случай връща false. NaN е специална стойност от типа Number, която обозначава резултат, който не е валидно число, например резултата от 0 / 0.
Преобразуването има значение: isNaN("hello") и isNaN(undefined) връщат true, но isNaN("42"), isNaN("") и isNaN(null) връщат false. Празният низ и null се преобразуват до 0. Извикването на isNaN() без аргумент се държи като подаване на undefined и връща true.
Number.isNaN(value) не извършва преобразуване: тя връща true само за стойността Number NaN. Използвайте я, когато искате да проверите самата стойност, а не резултата от преобразуването ѝ. Не сравнявайте с NaN чрез ===, защото дори NaN === NaN дава false. Резултат false от isNaN не доказва, че аргументът е число или че е краен: isNaN(Infinity) също дава false.
Преобразуването може да хвърли изключение вместо да върне булева стойност. Аргумент от тип Symbol или BigInt, например isNaN(1n), причинява TypeError. Преобразуването на обект може да изпълни кода му за преобразуване и да препрати възникнало изключение. Затова не използвайте isNaN като безопасен валидатор за произволни данни.
Примери
const values = [NaN, "hello", "42", "", null, undefined, Infinity];
for (const value of values) {
console.log(`${String(value)}: ${isNaN(value)} / ${Number.isNaN(value)}`);
}Резултат
NaN: true / true hello: true / false 42: false / false : false / false null: false / false undefined: true / false Infinity: false / false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.