feat: add catchunhandledpromiserejection.ukrainian.md

Author: Serhii Shramko

README.ukrainian.md

@@ -364,13 +364,13 @@ Read in a different language: [![CN](./assets/flags/CN.png)**CN**](./README.chin
 
 <br/><br/>
 
-## ![✔] 2.10 Catch unhandled promise rejections
+## ![✔] 2.10 Перехоплення необроблених відхилень промісів
 
-**TL;DR:** Any exception thrown within a promise will get swallowed and discarded unless a developer didn’t forget to explicitly handle it. Even if your code is subscribed to `process.uncaughtException`! Overcome this by registering to the event `process.unhandledRejection`
+**Коротко:** Будь-яке виключення, кинуте у промісі, буде проігнороване і втрачене, якщо розробник не забуде явно його обробити. Навіть якщо ваш код підписаний на `process.uncaughtException`! Перемогти це можна, зареєструвавшись на подію `process.unhandledRejection`.
 
-**Otherwise:** Your errors will get swallowed and leave no trace. Nothing to worry about
+**В іншому випадку:** Ваші помилки будуть проігноровані та залишаться безслідними. Нічого страшного.
 
-🔗 [**Read More: catching unhandled promise rejection**](./sections/errorhandling/catchunhandledpromiserejection.md)
+🔗 [**Читати більше: перехоплення необроблених відхилень промісів**](./sections/errorhandling/catchunhandledpromiserejection.ukrainian.md)
 
 <br/><br/>
 

sections/errorhandling/catchunhandledpromiserejection.ukrainian.md

@@ -0,0 +1,79 @@
+# Вловлювання необроблених відхилень промісів
+
+### Пояснення за один абзац
+
+Зазвичай, більша частина коду сучасних додатків Node.js/Express виконується у межах промісів – чи то в рамках обробника .then, зворотного виклику функції або у блоку catch. Дивно, але якщо розробник забуває додати .catch, помилки, кинуті в цих місцях, не обробляються подією uncaughtException і зникають. Нещодавні версії Node запровадили повідомлення про попередження, коли з'являється необроблене відхилення, хоча це й може допомогти помітити, коли щось пішло не так, але це очевидно не належний метод обробки помилок. Просте рішення – ніколи не забувати додавати .catch в кожен виклик ланцюга промісів та перенаправляти їх до централізованого обробника помилок. Однак, побудова стратегії обробки помилок тільки на дисципліні розробників є дещо крихкою. Тому настійно рекомендується використовувати елегантне відступне рішення та підписатись на `process.on('unhandledRejection', callback)` – це гарантує, що будь-яка помилка проміса, якщо її не оброблено локально, буде відповідно оброблена.
+
+### Приклад коду: ці помилки не будуть піймані жодним обробником помилок (крім unhandledRejection)
+
+```javascript
+DAL.getUserById(1).then((johnSnow) => {
+  // ця помилка просто зникне
+  if(johnSnow.isAlive === false)
+      throw new Error('ahhhh');
+});
+```
+
+### Приклад коду: Вловлювання нерозв'язаних та відхилених промісів
+
+<details>
+<summary><strong>Javascript</strong></summary>
+
+```javascript
+process.on('unhandledRejection', (reason, p) => {
+  // Я щойно піймав необроблене відхилення проміса,
+  // оскільки у нас вже є відступний обробник для необроблених помилок (дивіться нижче),
+  // давайте кинемо його та дозволимо йому впоратися з цим
+  throw reason;
+});
+
+process.on('uncaughtException', (error) => {
+  // Я щойно отримав помилку, яка ніколи не була оброблена, час впоратися з нею, а потім вирішити, чи потрібен перезапуск
+  errorManagement.handler.handleError(error);
+  if (!errorManagement.handler.isTrustedError(error))
+    process.exit(1);
+});
+```
+</details>
+
+<details>
+<summary><strong>Typescript</strong></summary>
+
+```typescript
+process.on('unhandledRejection', (reason: string, p: Promise<any>) => {
+  // Я щойно піймав необроблене відхилення проміса,
+  // оскільки у нас вже є відступний обробник для необроблених помилок (дивіться нижче),
+  // давайте кинемо його та дозволимо йому впоратися з цим
+  throw reason;
+});
+
+process.on('uncaughtException', (error: Error) => {
+  // Я щойно отримав помилку, яка ніколи не була оброблена, час впоратися з нею, а потім вирішити, чи потрібен перезапуск
+  errorManagement.handler.handleError(error);
+  if (!errorManagement.handler.isTrustedError(error))
+    process.exit(1);
+});
+```
+</details>
+
+### Цитата з блогу: "Якщо ви можете зробити помилку, то в якийсь момент ви її зробите"
+
+З блогу Джеймса Нельсона
+
+> Давайте перевіримо ваше розуміння. Які з наступних варіантів, на вашу думку, мають вивести помилку в консоль?
+
+```javascript
+Promise.resolve('обіцяне значення').then(() => {
+  throw new Error('помилка');
+});
+
+Promise.reject('значення помилки').catch(() => {
+  throw new Error('помилка');
+});
+
+new Promise((resolve, reject) => {
+  throw new Error('помилка');
+});
+```
+
+> Не знаю як ви, але я очікував би, що всі вони виведуть помилку. Однак, насправді, багато сучасних JavaScript-середовищ не виведуть помилки для жодного з них. Проблема з тим, що бути людиною означає, що якщо ви можете зробити помилку, то в якийсь момент ви її зробите. За таких обставин здається очевидним, що ми повинні проектувати речі таким чином, щоб помилки завдавали якомога менше шкоди, і це означає обробку помилок за замовчуванням, а не їх відкидання.