Без 800 пакетов в node_modules и тяжёлого Electron: три спорных, но рабочих принципа минимализма в JS-разработкеСтатья · дайджест за 21 ноября
Бумажный коллаж с чистым легким ядром кода и удаленными избыточными слоями библиотек
Статья4 раздела≈ 7 мин

Без 800 пакетов в node_modules и тяжёлого Electron: три спорных, но рабочих принципа минимализма в JS-разработке

«Заскамили людей мы. Обещали говорить про AI, а разговариваем про проблему, которая сложилась в отрасли», — с такой самоиронии Тимур Шемсединов (автор HowProgrammingWorks, 15 лет в JS, до этого .NET и Borland) и Влад Тен открыли свой совместный стрим. Впрочем, к нейросетям разговор всё равно вернулся — просто с неожиданной стороны.

Если отмотать на пять лет назад, когда никаких ИИ-агентов в редакторах ещё не было, JavaScript-проекты уже тонули в чужом коде, который никто не читал. Шемсединов выразился жёстко: «Это был нейрослоп, сгенерированный не AI-кой, а кучей неконтролируемых мозгов человеческих, которые залили всё это в npm». Открой node_modules в обычном веб-проекте — спорить трудно. Из этого разговора выросли три спорных, но рабочих правила минимализма: зачистка зависимостей, замена Electron на PWA и отказ от инлайн-типов TypeScript. Давай разберём, что реально работает, а где подход сам создаёт проблемы.

«Человеческий слоп» в npm и правило 12–30 зависимостей

Кажется, пакетный менеджер просто экономит время: вбил команду, взял готовую функцию и пошёл дальше. Но за безобидной библиотекой часто тянется хвост транзитивных зависимостей — пакетов, которые ты не ставил сам, их подтянули твои библиотеки, а те притащили ещё и свои. В итоге вместо пары утилит на диске лежит 800 папок от незнакомых авторов.

Фундаменту вроде V8, Node.js, браузера или PostgreSQL доверять нормально: за ними крупные команды и годы проверок. А вот мелкой библиотечке с одним случайным контрибьютором на GitHub — уже нет. Влад Тен привёл в пример сканер Socket, который подключают в CI-пайплайн для защиты от supply-chain атак — это когда злоумышленники взламывают или подменяют популярный пакет в npm, и вредоносный код попадает в тысячи проектов при обычном npm install. Дыры регулярно находят даже в крошечных пакетах для раскраски терминала на 20 000 установок. Классический мем экосистемы — поставить is-even для проверки чётности и получить «пакет для пакета».

С приходом вайбкодинга проблема только выросла: попроси ИИ собрать простую форму, и он по умолчанию притащит React и десятки пакетов там, где хватит пары файлов. Правило Шемсединова жёсткое, но понятное: держать 12–30 проверенных основных пакетов от авторов, чей код ты знаешь, фиксировать версии и вычитывать изменения при обновлении. Хорошие библиотеки не тащат мусор: с транзитивными такой набор вырастает примерно до 60 пакетов, но никогда до 800. В паре с проверкой вроде Socket или npm audit и жёстким lockfile это отрезает большую часть рисков.

Electron против PWA и Service Workers: зачем чату отдельный браузер

Вторая боль — заворачивать обычный веб-интерфейс в Electron ради «десктопного» приложения. Влад Тен выдал точное сравнение: «В третьем Battlefield здание рушится в реальном времени с лучами в 60 кадров в секунду, и при этом голосовой и текстовый чат работают. А просто Microsoft Teams у меня на компьютере лагает». Ожидание: ставишь клиент ради скорости. Реальность: получаешь ещё один Chromium, который ест память ради окна переписки.

Шемсединов напоминает: в браузере уже есть Web Components, Canvas, SVG, IndexedDB, WebUSB, Web Bluetooth и Web MIDI. А главная замена Electron — связка PWA и Service Worker API. Service Worker — это фоновый JS-скрипт браузера, который живёт отдельно от вкладки как локальный прокси-сервер. Он перехватывает сетевые запросы, держит кэш и связывает вкладки: даже 50 открытых вкладок могут идти через один воркер и одно соединение с сервером. А через Web Push API (стандарт доставки пушей в браузер) воркер просыпается и показывает уведомление, даже когда вкладка закрыта.

Официальная иллюстрация Progressive Web Apps (PWA) на платформе web.dev (Источник: web.dev)

Подключается такой воркер буквально в пару строк без сборщиков:

// Регистрируем Service Worker после загрузки страницы
if ('serviceWorker' in navigator) {
  window.addEventListener('load', () => {
    navigator.serviceWorker
      .register('/sw.js')
      .catch((err) => console.error('SW failed:', err));
  });
}

После вызова браузер загружает /sw.js, ставит воркер в фон и отдаёт ему контроль над запросами домена. Проверка in navigator и .catch() страхуют страницу, если браузер старый или скрипт не нашёлся.

«Погоди, неужели PWA реально заменит десктопный клиент?» — резонный вопрос. Тут важно не улететь в эйфорию. На iOS Safari (с версии 16.4) Web Push работает только если PWA добавлена на домашний экран (Add to Home Screen), а не из обычной вкладки. Плюс WebKit требует сразу показывать видимое уведомление через event.waitUntil(registration.showNotification(...)) — за «тихие» пуши Safari может отозвать права. И если приложению нужен полный доступ к локальной ФС, системным сокетам, трею или нативным бинарникам, без Electron не обойтись. Но для чата, CRM или трекера браузера часто хватает.

Чистый JS и отдельные .d.ts вместо TypeScript внутри кода

Самый острый тезис стрима — про TypeScript. Шемсединов не против типов, он против того, как они засоряют сам код: «Когда ты читаешь TypeScript, в 90% случаев глаза замыливаются от нагромождений юнионов и дженериков — суть не проглядывает через код». Влад со смехом подхватил: «any ты видишь!». Логика Тимура: в хорошем статическом языке типы выводятся сами, а в TS поверх динамического JS аннотации часто превращаются в шум.

Рабочая альтернатива описана в документации TypeScript. Ты пишешь чистый JavaScript, а контракты выносишь в отдельные файлы деклараций .d.ts (или JSDoc). Проверку берёт на себя tsc --noEmit с флагом checkJs:

{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": true,
    "noEmit": true,
    "strict": true
  },
  "include": ["src/**/*.js", "types/**/*.d.ts"]
}

Такой конфиг заставляет компилятор TypeScript проверять обычные .js-файлы строго по правилам strict, не генерируя при этом выходных файлов на диск. А сами контракты функций ты хранишь рядом в папке types, отдельно от бизнес-логики:

// types/math.d.ts — описываем сигнатуру отдельно от JS-кода
export declare function sum(a: number, b: number): number;

Плюс очевидный: .js-файлы исполняются в Node.js и браузере напрямую, без шага компиляции и путаницы с source maps. При этом IDE даёт подсказки, а tsc --noEmit ловит ошибки типов на этапе CI.

Похожий шаг в середине 2023 года сделала команда Svelte во главе с Ричем Харрисом. В спорах этот случай часто искажают, будто Svelte «бросил TypeScript». На деле с .ts на чистый JS + JSDoc перевели только внутреннюю кодовую базу самого компилятора и библиотеки, чтобы убрать сборку при разработке и ускорить отладку. Проверка через tsc --checkJs, генерация .d.ts и полная поддержка TypeScript для пользователей Svelte остались на месте.

Где минимализм окупается, а где превращается в изобретение велосипедов

Если свести все три оси в одну картину, сразу видно, чем ты выигрываешь и чем за это платишь.

Ось стекаПривычный стекМинималистичный вариантЧем придётся платить
ЗависимостиСотни пакетов в node_modules12–30 проверенных пакетов + аудитДольше старт, часть утилит пишешь сам
КлиентElectron-обёртка над вебомPWA + Service Worker и Web APIОграничения iOS Safari, нет полного доступа к ОС
ТипизацияИнлайн TypeScript (.ts)Чистый JS + .d.ts / JSDoc и checkJsРиск рассинхрона .d.ts с кодом, непривычно команде

Минимализм отлично окупается в компактных сильных командах, в open-source библиотеках и в проектах с жёсткими требованиями к безопасности: меньше чужого кода — меньше дыр и проще отладка. А вот в большой продуктовой команде на 50–200 человек отказ от привычного фреймворка и инлайн-TS легко бьёт по ногам. Вместо стандартного стека команда незаметно изобретает собственный недокументированный мини-фреймворк, а вынесенные в .d.ts типы быстро отстают от живого JS-кода, если на ревью за этим не следить железной рукой.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 6