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 (shocmd). 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
execFileyspawnejecutan otros programas con argumentos separados;execpasa por una terminal: cuidado con la inyección.- Escucha siempre el evento
errorde un proceso hijo. worker_threadsejecuta JavaScript pesado en otro hilo, comunicándose por mensajes.processda 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
Resuelto
Elige una respuesta en cada pregunta.
¿Para qué sirve
node:child_process?¿Por qué
exec("convert " + nombreDeArchivo)es peligroso?¿Qué diferencia hay entre
worker_threadsychild_process?¿Qué es
process.env?
Ordena la salida: Un hilo que trabaja aparte
Resuelto
Un hilo principal que lanza un worker. Ordena lo que aparecería en la terminal.
1// principal.mjs2import { Worker } from "node:worker_threads";3 4console.log("principal: lanzo el worker");5const w = new Worker(new URL("./calculo.mjs", import.meta.url), { workerData: 10 });6w.on("message", (r) => console.log("principal: recibí", r));7w.on("exit", () => console.log("principal: el worker terminó"));8console.log("principal: sigo libre");9 10// calculo.mjs11import { parentPort, workerData } from "node:worker_threads";12parentPort.postMessage(workerData * 2);Consola, de arriba abajo
- principal: sigo libre
- principal: el worker terminó
- principal: lanzo el worker
- principal: recibí 20
Crear el worker no detiene al hilo principal, que sigue con la línea siguiente. El worker arranca en paralelo, envía su resultado y, como no le queda nada por hacer, termina.
Detective: Un programa que no se encuentra
Resuelto
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.
Paso 2: ¿cómo lo arreglas?