Saltar al contenido
JavaScript en el servidor

Procesos e hilos

Lección 5 de 711 min3 ejercicios

A veces tu programa necesita ayuda de afuera: convertir un video con ffmpeg, ejecutar git, llamar a un script de Python. Otras veces, el trabajo pesado es tuyo y bloquearía el event loop. Node.js tiene una herramienta para cada caso: procesos hijos para otros programas, y worker threads para tu propio JavaScript en paralelo.

Ejecutar otros programas

import { execFile, spawn } from "node:child_process";
import { promisify } from "node:util";

// Un comando corto: esperar el resultado completo
const execFileP = promisify(execFile);
const { stdout } = await execFileP("git", ["log", "-1", "--format=%s"]);
console.log("último commit:", stdout.trim());

// Un proceso largo o con mucha salida: ir leyendo a medida que llega
const conversion = spawn("ffmpeg", ["-i", "video.mp4", "audio.mp3"]);
conversion.stderr.on("data", (parte) => process.stdout.write("."));
conversion.on("error", (e) => console.error("no se pudo ejecutar ffmpeg:", e.message));
conversion.on("close", (codigo) => console.log(codigo === 0 ? "\nlisto" : `\nfalló (${codigo})`));
  • execFile: ejecuta un programa con argumentos en un array y devuelve toda la salida.
  • spawn: igual, pero con streams para la entrada y la salida, para procesos largos.
  • exec: ejecuta un texto a través de una terminal (sh o cmd). Cómodo, pero peligroso.

worker_threads

Para cálculos pesados en JavaScript, un worker thread corre en otro hilo del mismo proceso, como los Web Workers del navegador:

// hash.mjs
import { parentPort, workerData } from "node:worker_threads";
import { scryptSync } from "node:crypto";

const resultado = scryptSync(workerData.clave, "sal", 64).toString("hex");
parentPort.postMessage(resultado);
// servidor.mjs
import { Worker } from "node:worker_threads";

function hashEnOtroHilo(clave) {
  return new Promise((resolver, rechazar) => {
    const w = new Worker(new URL("./hash.mjs", import.meta.url), { workerData: { clave } });
    w.once("message", resolver);
    w.once("error", rechazar);
  });
}

console.log(await hashEnOtroHilo("secreto"));

Crear un worker cuesta: para muchas tareas, se usa un pool de workers reutilizables (por ejemplo, con la librería Piscina). Y para tareas que Node.js ya hace fuera del hilo (leer archivos, la mayoría de la criptografía asíncrona), no hacen falta: usa sus versiones asíncronas.

El proceso actual

process tiene información y control sobre el programa que está corriendo:

console.log(process.argv);        // [ruta de node, ruta del script, ...argumentos]
console.log(process.env.HOME);    // variables de entorno
console.log(process.pid, process.platform, process.version);
console.log(process.memoryUsage().heapUsed);

// Terminar con orden cuando piden detener el programa (Ctrl+C, o el sistema)
process.on("SIGINT", async () => {
  console.log("cerrando conexiones…");
  await cerrarTodo();
  process.exit(0);   // 0: todo bien; otro número: hubo un error
});

El código de salida importa: los scripts, las herramientas de integración continua y los contenedores lo usan para saber si el programa terminó bien. process.exitCode = 1 lo fija sin cortar el programa en seco.

Resumen

  • execFile y spawn ejecutan otros programas con argumentos separados; exec pasa por una terminal: cuidado con la inyección.
  • Escucha siempre el evento error de un proceso hijo.
  • worker_threads ejecuta JavaScript pesado en otro hilo, comunicándose por mensajes.
  • process da los argumentos, las variables de entorno, las señales y el código de salida.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Más de un proceso, más de un hilo

Elige una respuesta en cada pregunta.

  1. ¿Para qué sirve node:child_process?

  2. ¿Por qué exec("convert " + nombreDeArchivo) es peligroso?

  3. ¿Qué diferencia hay entre worker_threads y child_process?

  4. ¿Qué es process.env?

Ordena la salida: Un hilo que trabaja aparte

Un hilo principal que lanza un worker. Ordena lo que aparecería en la terminal.

// principal.mjsimport { Worker } from "node:worker_threads"; console.log("principal: lanzo el worker");const w = new Worker(new URL("./calculo.mjs", import.meta.url), { workerData: 10 });w.on("message", (r) => console.log("principal: recibí", r));w.on("exit", () => console.log("principal: el worker terminó"));console.log("principal: sigo libre"); // calculo.mjsimport { parentPort, workerData } from "node:worker_threads";parentPort.postMessage(workerData * 2);

Consola, de arriba abajo

  1. principal: sigo libre
  2. principal: el worker terminó
  3. principal: lanzo el worker
  4. principal: recibí 20

Detective: Un programa que no se encuentra

Un script que convierte videos funciona en una computadora y en otra no. Encuentra la línea y elige el arreglo.

Consola

node:events:502
      throw er; // Unhandled 'error' event
      ^

Error: spawn ffmpeg ENOENT
    at ChildProcess._handle.onexit (node:internal/child_process:285:19)
    at onErrorNT (node:internal/child_process:483:16) {
  errno: -2,
  code: 'ENOENT',
  syscall: 'spawn ffmpeg',
  path: 'ffmpeg',
  spawnargs: [ '-i', 'video.mp4', 'audio.mp3' ]
}

Paso 1: toca la línea de código que causa el error.

domina-js · JavaScript en español, gratis y paso a paso.