CKTIS / JavaScript
Number.parseInt: analizar un prefijo entero
Number.parseInt convierte el argumento a texto y devuelve el entero del prefijo válido más largo en la base elegida, o NaN.
Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxis
Number.parseInt(string, radix)Number.parseInt(value, radix) aplica primero ToString, elimina espacios iniciales y reconoce un signo + o - opcional. radix pasa por ToInt32: tras la conversión, 0 elige la base predeterminada, 2..36 es válido y cualquier otro valor produce NaN. El análisis se detiene antes del primer dígito no válido para la base; así, "15px" en base 10 da 15 en vez de un error.
Con la base predeterminada se usa 10, salvo que un prefijo 0x/0X elija 16. Aquí no se reconocen 0b ni 0o; indicar la base es más seguro para datos de entrada. Si no consume ningún dígito válido, devuelve NaN; un resultado -0 conserva el signo. Un entero matemático muy grande se devuelve como Number y puede redondearse.
Number.parseInt existe desde ECMAScript 2015, es la misma función que parseInt global y no es constructor. BigInt se convierte primero a texto y puede perder precisión; Symbol lanza TypeError, y los objetos usados como valor o base pueden ejecutar código de conversión y propagar su excepción. Para exigir coincidencia total, valida primero todo el texto.
Ejemplos
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, prefijo 0x, NaN y signo de -0