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