UseProgram: примеры (JAVASCRIPT)

Примеры базового использования

Простой вызов с указанием имени программы:

const result = await useProgram('dataProcessor');
console.log(result);

{
  run: [Function],
  stop: [Function],
  getStatus: [Function],
  meta: { name: 'dataProcessor', version: '1.0.0' }
}

Использование с параметрами и колбэком:

useProgram('logger', {
  config: { level: 'debug' },
  dependencies: ['utils']
}, (prog, err) => {
  if (err) console.error(err);
  else prog.run();
});

// Программа 'logger' запущена в режиме debug

Использование флага mode:

const prog = await useProgram('analyzer', { mode: 'lazy' });
prog.run({ data: [1,2,3] });

// Анализ данных отложен до явного вызова run

Похожие функции в JavaScript

import(): Динамический импорт модулей. Возвращает Promise. Предпочтительнее для загрузки ES-модулей. require (в Node.js): Синхронная загрузка модулей в CommonJS. System.import (устаревший): Альтернатива для системных загрузчиков. Функция useProgram отличается более высокоуровневым API, ориентированным на управление жизненным циклом программы, а не только на загрузку кода.

Альтернативы в других языках программирования

В Python для подобных целей используют модуль importlib:

import importlib
module = importlib.import_module('module_name')
result = module.some_function()

# Загруженный модуль

В PHP часто применяют автозагрузку классов или функцию include:

$module = include('module.php');
$module->execute();

// Модуль выполнен

В C динамическая загрузка библиотек осуществляется через dlopen и dlsym. Эти подходы работают на уровне операционной системы и требуют явного управления памятью, в отличие от useProgram в JavaScript, которая работает в управляемой среде.

Типичные ошибки

Игнорирование асинхронной природы функции приводит к ошибкам:

const prog = useProgram('myProg'); // Ошибка: пропущен await
prog.run();

TypeError: Cannot read properties of undefined

Некорректная обработка ошибок в колбэке:

useProgram('unknown', null, (prog) => {
  prog.run(); // Ошибка, если программа не загрузится
});

Uncaught TypeError: prog is undefined

Неправильный формат параметров:

await useProgram('tool', 'configString'); // options должен быть объектом

ArgumentError: Options must be an object

История изменений

В версии 2.0 функция была полностью переписана для возврата Promise вместо использования только колбэков. Добавлена поддержка флага mode: 'lazy' для отложенной инициализации. В версии 2.1 в объект options добавлено свойство timeout для ограничения времени загрузки. Устаревший синтаксис с передачей конфигурации строкой был удалён в версии 3.0.

Расширенные примеры использования

Каскадная загрузка нескольких зависимых программ:

async function loadPipeline() {
  const [parser, validator] = await Promise.all([
    useProgram('dataParser', { config: { format: 'json' } }),
    useProgram('validator')
  ]);
  const processor = await useProgram('processor', {
    dependencies: ['dataParser', 'validator']
  });
  return processor.run({ parser, validator });
}
loadPipeline().then(console.log);

// Конвейер программ успешно запущен

Использование с обработкой таймаута:

async function loadWithTimeout(progName, ms) {
  const timeoutPromise = new Promise((_, reject) => {
    setTimeout(() => reject(new Error('Timeout')), ms);
  });
  return await Promise.race([
    useProgram(progName),
    timeoutPromise
  ]);
}

// Загрузка либо завершится, либо прервётся по истечении времени

Интеграция с системой событий:

const eventEmitter = new EventEmitter();
const program = await useProgram('monitor', { config: { events: eventEmitter } });
eventEmitter.on('data', (d) => program.run(d));

// Программа реагирует на события

Создание программы-обёртки с мемоизацией:

const programCache = new Map();
async function getCachedProgram(name, options) {
  const key = JSON.stringify({ name, options });
  if (!programCache.has(key)) {
    programCache.set(key, await useProgram(name, options));
  }
  return programCache.get(key);
}

// Повторные вызовы с теми же параметрами возвращают кэшированный экземпляр