Исполняемые файлы Node.js: от запуска до упаковки

Расширенные примеры работы с node.exe и создания exe

Пример 1. Запуск HTTP-сервера с аргументами порта

Создайте файл server-args.js:

const http = require('http');
const port = parseInt(process.argv[2], 10) || 3000;

const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Server running on port ' + port);
});

server.listen(port, () => {
  console.log('Listening on port', port);
});

Запустите с указанием порта:

node server-args.js 4000

Listening on port 4000

Откройте в браузере http://localhost:4000. Если аргумент не передан, сервер стартует на порту 3000.

Пример 2. Использование process.env для конфигурации

Создайте config-app.js:

const http = require('http');
const port = process.env.PORT || 8080;
const message = process.env.MESSAGE || 'Default message';

http.createServer((req, res) => {
  res.end(message);
}).listen(port, () => console.log('Server on', port));

Запустите с установленными переменными (в cmd):

set PORT=5000 && set MESSAGE=HelloFromEnv && node config-app.js

Server on 5000

В Windows PowerShell используйте $env:PORT=5000. Такой подход удобен для контейнеризации и CI/CD.

Пример 3. Упаковка приложения с помощью nexe

Установите nexe:

npm install -g nexe

Подготовьте файл cli.js – простую CLI-утилиту:

#!/usr/bin/env node
const [,, ...args] = process.argv;
console.log('Arguments received:', args);

Соберите исполняемый файл:

nexe cli.js -t windows-x64-20.11.0 -o mycli.exe

Параметр -t задаёт целевую платформу и версию Node.js (можно опустить, nexe выберет подходящую). Проверьте сборку:

mycli.exe hello world

Arguments received: [ 'hello', 'world' ]

Важно: nexe требует компилятор C++ (Visual Studio Build Tools на Windows), если не используется предварительно собранный бинарник. При возникновении ошибок установите windows-build-tools.

Пример 4. Запуск отладчика с точкой остановки в REPL

Можно войти в режим отладки прямо из REPL. Запустите node inspect и затем используйте команды:

node inspect
> .load test.js
> debugger
> cont

Однако чаще используют файл. Создайте debug-sample.js:

function factorial(n) {
  if (n <= 1) return 1;
  debugger;
  return n * factorial(n - 1);
}
factorial(5);

Запустите отладчик:

node inspect debug-sample.js

Пошагово пройдите по рекурсии с командами next, step, watch.

Пример 5. Комбинация флагов: проверка синтаксиса и выполнение

Используйте --check, чтобы проверить файл без выполнения:

node --check app.js

Если ошибок нет, ничего не выводится. Если есть – покажет синтаксическую ошибку. Это удобно в pre-commit хуках.

node --check -e "console.log('valid')"

Флаг --harmony включает экспериментальные возможности V8 (например, --harmony-array-flat).

Пример 6. Использование process.stdin в конвейере

Создайте transform.js – утилита, преобразующая текст в верхний регистр:

process.stdin.setEncoding('utf8');
let data = '';
process.stdin.on('readable', () => {
  let chunk;
  while ((chunk = process.stdin.read()) !== null) {
    data += chunk;
  }
});
process.stdin.on('end', () => {
  process.stdout.write(data.toUpperCase());
});

Запустите с перенаправлением ввода:

echo "hello node" | node transform.js

HELLO NODE

На Windows перенаправление работает в cmd, в PowerShell используйте Get-Content input.txt | node transform.js.

Пример 7. Упаковка приложения с помощью pkg и встроенных ресурсов

Создайте readme.txt рядом с скриптом. В скрипте resource-app.js:

const fs = require('fs');
const path = require('path');
const content = fs.readFileSync(path.join(__dirname, 'readme.txt'), 'utf8');
console.log(content);

Обновите package.json, добавив секцию pkg:

{
  "name": "resource-app",
  "pkg": {
    "assets": "readme.txt"
  }
}

Затем соберите:

pkg resource-app.js --targets win-x64 --output resource-app.exe

Теперь exe содержит readme.txt внутри. При запуске он будет извлечён во временную папку (но для чтения это прозрачно).

Для более сложных случаев (загрузка динамических модулей) используйте pkg.scripts с перечислением всех JS-файлов.