Вокруг Express есть документация, примеры приложений и отдельные middleware. Прежде чем переносить найденный фрагмент, определите версию: код с express.bodyParser или app.configure относится к старому стеку, а номер пакета в современном проекте не делает такой пример совместимым автоматически.
Где задавать вопросы
Старая страница приглашала в Google Group и канал #express на freenode и приводила число участников. Эти числа не характеризуют нынешнее сообщество, а доступность старых каналов здесь не подтверждается. Выбирайте точки входа на официальной странице сообщества Express.
Для полезного вопроса приложите версию Node.js и Express, минимальный маршрут, точный запрос и ожидаемый статус/ответ. Пароли, cookies сессии, пользовательские записи и токены в пример не включайте. Если ошибка связана с прокси, опишите путь запроса и настройки доверия к заголовкам без раскрытия секретов.
Как читать примеры
Примеры Express 3.0.0beta7 полезны для понимания существующего приложения: там видны порядок middleware, организация маршрутов и интеграция шаблонов. Это зафиксированный релиз, а не плавающий master, который может уже содержать другой API.
- Найдите в package.json основную версию Express и зависимых middleware.
- Выделите обработчик запроса и его входные данные.
- Проверьте, где ответ завершается и куда передаётся ошибка.
- Сопоставьте старые методы с переходом на Express 4 и Express 5.
- Запускайте старые зависимости только в изолированном исследовательском окружении, а не на публичном сервере.
Как сообщить об ошибке
В issue tracker Express сначала ищут похожую проблему и читают действующие правила проекта. Отчёт должен отделять ошибку фреймворка от ошибки приложения: минимальный пример, шаги воспроизведения, фактический и ожидаемый результат.
Проблема только в неподдерживаемой 3.x не означает, что она остаётся в текущем релизе. Проверьте поведение на поддерживаемой версии, если это возможно. Сведения об уязвимости не публикуйте вместе с рабочими секретами; используйте официальную политику безопасности.
Как выбирать расширения
Старая подборка отправляла к wiki Connect и общему wiki Express. В Express 4 middleware отделили от ядра, поэтому для текущего проекта начните с официального перечня middleware, затем проверьте README, поддержку вашей версии Node.js, журнал изменений и сообщения безопасности конкретного пакета.
Сравнивайте назначение, а не только похожее имя: JSON-парсер не принимает multipart-файлы; cookie-parser не хранит серверную сессию; метод override не выполняет авторизацию. Добавляйте пакет там, где его работа нужна, с понятными лимитами и порядком выполнения.
Документация старых версий
Ссылка «2x» из исходной страницы заменена на справочник Express 2.x. Для 3.x доступны API, руководство и FAQ. Выбирайте версию по приложению, которое разбираете; не используйте старые инструкции как рекомендацию выбора зависимостей для нового сервиса.
Исходная страница сообщества: © 2012 TJ Holowaychuk; публикация JSman. Числа участников и неподтверждённые старые каналы заменены практическими ориентирами.