Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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