CKTIS / JavaScript
Number — converter valores em números
Number(value) converte um valor num número primitivo. Saiba qual é a diferença entre esta conversão e o objeto wrapper new Number(value), e como Number.prototype.toString converte um número em texto.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
Number(value)
Number()
new Number(value)
number.toString(radix)Number(value) devolve um valor primitivo do tipo number; Number() devolve 0. Em contrapartida, new Number(value) cria um objeto wrapper: o seu typeof é "object", não "number". Para cálculos e conversões habituais, utilize a chamada sem new.
A conversão de cadeias de caracteres considera a representação completa depois de remover os espaços em branco no início e no fim: Number("255px") produz NaN, enquanto Number("") produz 0. Number(null) produz 0, Number(undefined) produz NaN, e os valores booleanos tornam-se 1 ou 0. A conversão de um Symbol lança um TypeError. Number pode converter explicitamente um BigInt, mas o resultado pode perder precisão.
O tipo number utiliza o formato binário IEEE 754 de precisão dupla: muitas frações decimais são aproximadas. O intervalo dos números inteiros seguros vai de -(2 ** 53 - 1) a 2 ** 53 - 1; fora desse intervalo, nem todos os números inteiros são representados com exatidão.
Number.prototype.toString funciona no sentido oposto: value.toString(radix) devolve texto. A base predefinida é 10; utilize uma base inteira entre 2 e 36, como 16 para hexadecimal. Uma base fora do intervalo após a conversão lança um RangeError. O método exige que this seja um número ou um objeto Number; outro recetor causa um TypeError.
Exemplos
const value = Number(" 255 ");
console.log(typeof value);
console.log(value);
console.log(value.toString(16));
console.log(Number(""));
console.log(Number.isNaN(Number("255px")));Resultado
number 255 ff 0 true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.
Fontes
- ECMAScript® Language Specification
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® Language Specification — The Number Constructor
- ECMAScript® Language Specification — Number.prototype.toString
- ECMAScript® Language Specification — Numbers and Dates
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- Official reference — developer.mozilla.org: Number / toString