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

CKTIS / JavaScript

Number.parseInt: analisar um prefixo inteiro

Number.parseInt converte o argumento para texto e devolve o inteiro do prefixo válido mais longo na base escolhida, ou NaN.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

Number.parseInt(string, radix)

Number.parseInt(value, radix) aplica primeiro ToString, remove espaços iniciais e reconhece um sinal + ou - opcional. radix passa por ToInt32: após a conversão, 0 escolhe a base predefinida, 2..36 é válido e qualquer outro valor produz NaN. A análise para antes do primeiro dígito inválido para a base; assim, "15px" na base 10 dá 15 em vez de erro.

Com a base predefinida usa-se 10, exceto quando um prefixo 0x/0X seleciona 16. Os prefixos 0b e 0o não são reconhecidos; indicar a base é mais seguro para dados de entrada. Sem consumir um dígito válido, o resultado é NaN; um resultado -0 conserva o sinal. Um inteiro matemático muito grande é devolvido como Number e pode ser arredondado.

Number.parseInt existe desde ECMAScript 2015, é a mesma função que parseInt global e não é construtor. BigInt é primeiro convertido para texto e pode perder precisão; Symbol lança TypeError, enquanto objetos usados como valor ou base podem executar código de conversão e propagar a exceção. Para exigir correspondência total, valida primeiro todo o texto.

Exemplos

console.log(Number.parseInt("42", 10), Number.parseInt("0x10", 16), Number.parseInt("101", 2));
console.log(Number.parseInt("15px", 10), Number.parseInt("bad", 10));
console.log(Number.parseInt("0x10"), Number.parseInt("0x10", 10));
console.log(Object.is(Number.parseInt("-0", 10), -0), Number.parseInt === parseInt);
console.log(Number.parseInt("10", 1), Number.parseInt("10", 37));
try { Number.parseInt(Symbol("x"), 10); } catch (error) { console.log(error instanceof TypeError); }

Resultado

42 16 5
15 NaN
16 0
true true
NaN NaN
true

Number.parseInt → bases explícitas, prefixo 0x, NaN e sinal de -0

Fontes