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.

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)devuelve12, no un error. - Decimales:
parseInt("4.8", 10)devuelve4; 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); // 24parseInt 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
NaNantes 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.