parseInt en JavaScript - uso correcto y errores frecuentes

18 de octubre de 2026

Manejo de errores en JavaScript. El monitor muestra "ERROR!".

En una actividad de robótica, el alumnado introduce «12» en un formulario y el programa necesita usarlo como número para fijar la velocidad del motor. En JavaScript, parseInt(cadena, 10) suele convertir ese texto a entero, pero puede aceptar solo una parte de la entrada y dejar pasar un dato que no era válido.

Tutorial de JavaScript: cómo convertir un string a número, con ejemplo de JS String to Int.

La conversión depende de la base y del contenido de la cadena

  • Base decimal: usa parseInt(texto, 10) si esperas un entero en base 10.
  • Lectura parcial: parseInt("12px", 10) devuelve 12, no un error.
  • Decimales: parseInt("4.8", 10) devuelve 4; no redondea.
  • Validación estricta: comprueba el formato completo antes de aceptar un dato de usuario.
  • Otra base: el segundo argumento, llamado radix o base, permite interpretar binario, hexadecimal y otras bases.

El segundo argumento evita interpretar mal la base

Una cadena como "101" puede representar ciento uno en decimal o cinco en binario. El parámetro radix elimina esa ambigüedad: parseInt("101", 10) da 101, mientras que parseInt("101", 2) da 5. Para una entrada habitual de clase, indicar la base 10 de forma explícita hace que la intención del código se entienda a simple vista.

La función admite bases entre 2 y 36. Si no indicas ninguna, JavaScript usa base 10 salvo que la cadena empiece por el prefijo hexadecimal 0x; por ejemplo, parseInt("0xFF") devuelve 255. La especificación ECMAScript define este comportamiento, y la recomendación práctica es sencilla: para cantidades decimales, escribe el segundo argumento.

const nivel = parseInt("101", 2);  // 5
const hexadecimal = parseInt("FF", 16);  // 255
const cantidad = parseInt("24", 10);  // 24

parseInt acepta un prefijo, no necesariamente toda la entrada

Este detalle puede convertir un error de entrada en un valor aparentemente correcto: parseInt("12px", 10) devuelve 12, porque la función deja de leer al encontrar la letra. También ignora el decimal, así que parseInt("4.8", 10) produce 4. No uses ese resultado como prueba de que la cadena completa era un entero válido.

Para datos escritos por estudiantes, conviene separar dos tareas: comprobar que la entrada cumple el formato esperado y convertirla después. Si el campo debe contener solo dígitos, una validación con una expresión regular permite rechazar tanto "12px" como "4.8" antes de actualizar un motor o una puntuación.

Entrada o situación Qué ocurre Qué hacer
"12px" con base 10 Devuelve 12; lee el prefijo numérico. Valida la cadena completa si el campo solo admite enteros.
"4.8" con base 10 Devuelve 4; descarta la parte decimal. Usa parseFloat o Number si necesitas conservar decimales.
"hola" con base 10 Devuelve NaN, que señala que no se pudo obtener un número. Comprueba el resultado con Number.isNaN y muestra un aviso.
"101" con base 2 Devuelve 5, porque interpreta los dígitos como binarios. Confirma que la entrada y el radix usan la misma base.

Pasar parseInt directamente a map produce resultados inesperados

Una actividad corta con un array permite descubrir una trampa poco visible: ["1", "7", "11"].map(parseInt) devuelve [1, NaN, 3], no tres valores decimales. map llama a la función con el elemento y también con su índice; como el índice ocupa el segundo parámetro, acaba funcionando como radix en cada llamada. El fallo está en los argumentos que recibe la función, no en el contenido del array.

La solución es envolver la conversión en una función que ignore el índice y especifique la base:

const valores = ["1", "7", "11"].map(texto => parseInt(texto, 10));
// [1, 7, 11]

Creo que este ejemplo funciona especialmente bien en programación educativa porque el error se ve en la consola y obliga a preguntar qué argumentos pasa realmente una función de orden superior. En una práctica con sensores, el mismo principio ayuda a entender por qué una lectura procesada en lote puede comportarse distinto de una conversión aislada.

El mismo nombre no significa la misma conversión en todos los lenguajes

Si el grupo alterna JavaScript, Python y Java, conviene evitar una equivalencia automática entre funciones. En JavaScript, parseInt puede quedarse con el prefijo válido; en Python, int("12px") produce un error, y en Java, Integer.parseInt("12px") lanza una excepción. El contraste sirve para enseñar que cada lenguaje define su propia política ante una cadena mal formada.

Lenguaje Conversión decimal habitual Qué pasa con "12px"
JavaScript parseInt("12", 10) Devuelve 12; acepta el prefijo.
Python int("12") Genera ValueError.
Java Integer.parseInt("12") Genera NumberFormatException.

La documentación de Python describe la conversión con int, mientras que la API de Java para Integer.parseInt especifica que los caracteres de la cadena deben formar un entero válido para la base elegida. Al comparar estos casos, se puede pedir al alumnado que decida si una entrada incorrecta debe detener el programa, mostrar un mensaje o activar un valor alternativo.

Una regla sencilla ayuda a elegir la conversión correcta

Antes de convertir, decide qué representa el campo. Para una cantidad entera decimal, usa parseInt(valor, 10); para una medida con decimales, emplea parseFloat o Number; si necesitas rechazar texto adicional, valida primero toda la cadena. En el material de MDN sobre parseInt también se explica que la función devuelve NaN cuando no puede interpretar un dígito inicial válido.

  • Esperas un entero decimal: convierte con base 10 y valida el formato completo.
  • Esperas un decimal: evita parseInt, porque elimina la fracción.
  • Esperas binario o hexadecimal: pasa la base de forma explícita y comprueba que los caracteres sean válidos.
  • El valor llega de un formulario o sensor: gestiona NaN antes de usarlo en cálculos o movimientos.

Un valor convertido todavía necesita una comprobación final

Convertir una cadena y aceptar el dato son decisiones distintas. En una actividad con un robot, una entrada incompleta podría producir un número que parece válido y alterar la consigna; por eso, la lógica debe comprobar el formato y el rango permitido antes de enviar el valor al dispositivo.

Si el campo representa una velocidad, por ejemplo, define primero qué valores admite el programa y qué mensaje aparece cuando la entrada queda fuera de ese margen. Así, parseInt cumple su función concreta de conversión, mientras que la actividad conserva el control sobre los datos que realmente llegan al robot.

Preguntas frecuentes

El segundo argumento, llamado radix o base, evita ambigüedades. Por ejemplo, parseInt("101", 10) devuelve 101, mientras que parseInt("101", 2) devuelve 5. JavaScript admite bases entre 2 y 36, por lo que conviene escribir la base 10 de forma explícita para cantidades decimales.
parseInt("12px", 10) devuelve 12 porque solo lee el prefijo numérico, y parseInt("4.8", 10) devuelve 4 porque descarta la parte decimal. Si el campo debe contener únicamente un entero, hay que validar toda la cadena antes de convertirla. Para conservar decimales, es preferible usar parseFloat o Number.
map pasa a su función el elemento y también su índice. En una llamada directa a parseInt, ese índice ocupa la posición del radix, de modo que la base cambia en cada elemento. Para evitarlo, envuelve la conversión en una función y fija la base: ["1", "7", "11"].map(texto => parseInt(texto, 10)).
Siempre que el valor proceda de un formulario o sensor y vaya a emplearse en cálculos, puntuaciones o movimientos de un robot. Si la cadena no empieza con un dígito válido, parseInt devuelve NaN, que se puede comprobar con Number.isNaN. Además, hay que verificar el formato completo y el rango permitido antes de enviar el valor al dispositivo.
Calificar artículo

Promedio: 4.3 / 5 · 6 calificaciones

Etiquetas

javascript nan parseint radix validación
Comentarios (0)
Añadir comentario