javascript-pro - Модули и асинхронный JavaScript

Когда звать

• Когда JavaScript-модуль теряет ошибки Promise или смешивает ESM с CommonJS.
• Когда нужны проверки браузерного кода, фоновых вычислений или сервиса Node.js.

Какие задачи берёт JavaScript Pro

JavaScript Pro описывает работу агента с обычным JavaScript в браузере и Node.js. В области применения автор перечисляет асинхронные операции, системы модулей, Web Workers, Service Workers и потребление памяти. Проверенный файл имеет версию 1.1.0; в нём заявлен ориентир на ES2023 и новее.

Начинать предлагается с package.json, версии Node.js и целевых браузеров. Агент должен выяснить, что означают расширения .js, .mjs и .cjs в конкретном проекте. Такой разбор особенно важен перед переносом небольшого скрипта в приложение: одинаковая запись импорта может зависеть от настроек запуска.

Асинхронность и обработка ошибок

Исходник требует спланировать модули, поток асинхронных операций и обработку отказов до реализации. В примере Fetch автор проверяет response.ok, затем читает JSON и перехватывает исключение. Возвращаемый при ошибке null тоже должен учитываться вызывающим кодом.

Автор запрещает необработанные ошибки асинхронных функций и блокирующие операции в браузере. Для Node.js отдельно запрещён синхронный ввод-вывод. При ревью можно попросить агента показать, где операция ждёт диск или сеть и как это ожидание влияет на остальные запросы.

В разделе синтаксиса показано различие между ?? и || при выборе значения по умолчанию. Скилл предпочитает optional chaining, const и let, ESM для новых проектов и именованные экспорты библиотечных функций. Смешивать require и import внутри одного модуля инструкция не предлагает.

Как автор предлагает принимать результат

После написания кода агент запускает линтер и исправляет замечания. Затем проверяет утечки памяти через DevTools или режим --inspect, оценивает размер сборки и добавляет тесты Jest. Указанное в исходнике покрытие от 85% является требованием к результату задачи, а не измерением качества установленного скилла.

Отдельные справочники посвящены современному синтаксису, Promise и циклу событий, модулям, браузерным API и инструментам Node.js. В последнем перечислены потоки, fs/promises, EventEmitter и worker threads. При копировании сохраните весь каталог references, чтобы агент мог открыть нужную тему.

С какой проверкой начать

Для первого задания подойдёт загрузчик данных: «Проверьте обработку неуспешного HTTP-ответа и повреждённого JSON. Добавьте тесты с подменённым Fetch и покажите, что после отказа не остаётся необработанного Promise». Это пример задания для пользователя, не выполненная нами проверка.

Попросите приложить модуль с экспортами, тестовый файл и JSDoc сложных функций. Если задача затрагивает производительность, нужен фактический замер; переписанный синтаксис сам по себе не доказывает ускорение. Пункт исходника про запись X | null нельзя механически вставлять в обычный .js как аннотацию TypeScript.

Способы подключения взяты из QUICKSTART коллекции. Плагин добавляет набор скиллов, а не только JavaScript Pro; установку мы не запускали, совместимость с Codex не проверяли. Для типизированного контракта рядом есть TypeScript Pro.