Обработка ошибок в Promise и async/await

Цель

Каждый отклонённый промис либо обрабатывается там, где можно сделать что-то полезное, либо явно отражается в журнале как сбой с контекстом. Ни один не теряется молча и не завершает процесс неожиданно.

Предварительные условия

Функция async всегда возвращает промис: throw внутри превращается в отклонение, а await отклонённого промиса повторно возбуждает ошибку в этой точке (MDN). Нужно знать политику среды выполнения в отношении отклонений, которые никто не обработал: браузеры вызывают событие unhandledrejection на window; Node.js при настройке по умолчанию --unhandled-rejections=throw поднимает его как неперехваченное исключение, которое завершает процесс, если не обработано.

Шаги

1. Для каждого вызова с await решите, может ли вызывающий код восстановиться: повторить попытку, перейти к запасному варианту, показать сообщение. Только тогда оборачивайте его: try { data = await load(); } catch (e) { ... } вокруг операторов, которые могут завершиться ошибкой, а не вокруг всей функции.
2. Если восстановиться нельзя, дайте отклонению распространиться дальше или повторно возбудите более конкретную ошибку, сохранив исходную причину (new Error("profile load failed", { cause: e })), чтобы не потерять стек.
3. Никогда не оставляйте промис без присмотра. Вызов без await, return или .catch оставляет отклонение без ответственного обработчика; включите правило линтера для промисов без ожидания и исправьте каждое срабатывание.
4. Не смешивайте цепочки .then() и await в одной функции; пропущенный return внутри .then скрывает сбой от окружающего try.
5. Для параллельной работы выбирайте осознанно: Promise.all, если один сбой делает весь пакет непригодным, и Promise.allSettled, если полезны частичные результаты. В обоих случаях каждый входной промис получает обработчик, поэтому более поздние сбои не становятся необработанными.
6. Зарегистрируйте обработчик последней защиты, записывающий причину и происхождение промиса: window.addEventListener("unhandledrejection", ...) в браузере, process.on("unhandledRejection", ...) в Node.js. В серверном процессе запишите ошибку и завершитесь, а не продолжайте работу в неизвестном состоянии.
7. Всегда отклоняйте промисы экземплярами Error; строка в качестве причины отклонения не имеет ни трассировки стека, ни cause.
8. Для каждого документированного пути отказа напишите тест, проверяющий тип и сообщение отклонения.

Ожидаемый результат

Каждый сбой появляется один раз, в одной строке журнала с контекстом, на том уровне, где было принято решение о его обработке. В запусках CI нет предупреждений о необработанных отклонениях.

Ограничения и основания проверки

Отмена не является ошибочной ситуацией; AbortError от отменённого fetch нужно распознать и проигнорировать, а не сообщать о нём как об ошибке. Описанное поведение соответствует указанной документации; измерения не заявлены.