Un problema común mientras se trabaja en un proyecto JavaScript Node.js es el error «JavaScript heap out of memory». Este error suele producirse cuando la memoria por defecto asignada por tu sistema a Node.js no es suficiente para ejecutar un proyecto grande.
El error es común si ejecutas tu proyecto en Windows, macOS o una distribución de Linux como Ubuntu. Por suerte, hay algunas soluciones fáciles que pueden ayudar a resolver el error «JavaScript heap out of memory».
¿Qué es la memoria de montón?
Antes de ver cómo solucionar el error, es útil entender qué es la memoria heap y cómo la usan los programas.
La memoria asignada en el heap del sistema también se llama memoria asignada dinámicamente. Depende del programador utilizar la memoria disponible como mejor le parezca. Lo más importante es que el tamaño del heap para un programa depende de la memoria virtual disponible que se le haya asignado.
Si estás ejecutando un proyecto relativamente grande, puede requerir más memoria que el trozo asignado por defecto. Esto puede hacer que su proyecto se bloquee y registre el error «JavaScript heap out of memory».
Cómo solucionar el problema de memoria insuficiente de JavaScript en Windows
Independientemente de su IDE, la solución de «JavaScript heap out of memory» es idéntica.
Puedes añadir una variable de entorno a través del Panel de Control para aumentar la memoria asignada a un proyecto Node.js.
- Abre el menú Inicio, busca Configuración avanzada del sistema, y selecciona la mejor opción.
- En el cuadro de diálogo, haz clic en Variables de entorno, y luego haz clic en Nueva desde Variables de sistema o Variables de usuario. Las primeras se aplican a todos los usuarios de su ordenador, mientras que las segundas sólo afectan a su cuenta actual
- En el campo Nombre de la variable introduzca NODE_OPTIONS. En el campo Valor de la variable introduzca –max-old-space-size=4096. Este valor asignará 4GB de memoria virtual a Node.js. Para establecer un valor diferente, multiplique la cantidad que necesita en GB por 1024 (el valor de la variable debe estar en MB).
- Haga clic en Aceptar para guardar sus cambios, luego haga clic en Aplicar y finalmente haga clic en Aceptar una vez más. Reinicie su proyecto para que los cambios surtan efecto.
También puedes establecer una variable de entorno a través de un terminal de Windows PowerShell.
Inicie un terminal PowerShell, escriba el siguiente comando y pulse Enter:
$env:NODE_OPTIONS="--max-old-space-size=4096"Si sólo desea aumentar la memoria de la pila temporalmente, ejecute el siguiente comando en un terminal PowerShell antes de ejecutar su proyecto:
set NODE_OPTIONS=Una vez que hayas introducido este comando, puedes desplegar/ejecutar tu proyecto usando npm run dev o tu propio script.
Recuerda siempre introducir el tamaño de memoria requerido en MB. No hacerlo puede causar un comportamiento inesperado en su programa. También es vital no asignar toda la memoria disponible ya que esto puede causar un fallo importante en el sistema.
Cómo solucionar el error de memoria insuficiente de JavaScript en macOS y Linux
En macOS y Linux, la corrección de la memoria de la pila es muy similar. Debes exportar una variable de entorno que especifique la cantidad de memoria virtual asignada a Node.js.
En tu terminal, antes de ejecutar tu proyecto, introduce el siguiente comando y pulsa Enter:
export NODE_OPTIONS=--max-old-space-size=4096Esto asignará 4GB de memoria virtual al espacio de ejecución de Node.js. Para establecer una cantidad diferente de memoria, sustituya 4096 por la cantidad requerida en MB.
Evitar el error de memoria de JavaScript Heap Out of Memory
Puedes evitar este error asegurándote de que tu programa no tenga fugas de memoria. La gestión adecuada de la memoria es crucial al escribir sus programas, especialmente en un lenguaje de bajo nivel.
Si bien el aumento de la memoria asignada solucionará temporalmente el problema, debe encontrar la causa raíz y solucionarla.