@dxtmisha/wiki 0.59.1 → 0.65.0

package/src/media/functional/functional-basic/classes/ApiErrorStorage/ApiErrorStorage.ru.mdx

@@ -0,0 +1,51 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ApiErrorStorage - Управление ошибками'/>
+
+# Класс ApiErrorStorage
+
+Класс `ApiErrorStorage` является **менеджером для обработки и идентификации состояний ошибок API**. Он обеспечивает централизованное хранилище критериев ошибок API, позволяя системе идентифицировать конкретные ошибки путем сопоставления статуса ответа, кода ошибки из тела JSON, метода запроса и URL.
+
+## Ключевые особенности
+
+- **Централизованное хранилище** — агрегация всех известных паттернов ошибок API в одном месте для единообразной обработки.
+- **Сопоставление по паттернам** — идентификация ошибок по статусу HTTP, пользовательским кодам ошибок, методам запроса или шаблонам URL (включая RegExp).
+- **Структурированное преобразование** — преобразование сырых сетевых ошибок в структурированные элементы ошибок прикладного уровня.
+- **Пользовательская валидация** — поддержка кастомных функций валидации для сложных сценариев идентификации ошибок.
+
+## Методы
+
+### Управление
+
+- `add(item: ApiErrorStorageItem | ApiErrorStorageList): this` — Добавляет один или несколько элементов или списков ошибок во внутреннее хранилище.
+
+### Идентификация
+
+#### `find`
+
+Ищет подходящий элемент ошибки в хранилище путем анализа ответа. Автоматически пытается извлечь код и сообщение об ошибке из тела ответа.
+
+**Параметры:**
+- `method: ApiMethodItem` — HTTP-метод, использованный для запроса.
+- `response: Response` — Объект ответа Fetch API.
+
+**Возвращает:** `Promise<ApiErrorStorageItem>` — Найденный элемент ошибки или сгенерированный элемент ошибки, если совпадений не найдено.
+
+```javascript
+const errorItem = await errorStorage.find(ApiMethodItem.get, response);
+
+if (errorItem.code === 'USER_NOT_FOUND') {
+  // Обработка конкретной ошибки
+}
+```
+
+## Типы
+
+### ApiErrorStorageItem
+
+- `url: string | RegExp` — Строка URL или регулярное выражение для сопоставления с URL запроса.
+- `method: ApiMethodItem` — HTTP-метод, необходимый для совпадения.
+- `code?: string` — Необязательный код ошибки для сопоставления с телом JSON.
+- `status?: number` — Необязательный код статуса HTTP для сопоставления.
+- `validation?: (response: Response) => boolean` — Необязательная функция пользовательской валидации.
+- `message?: string | ((response?: Response) => string)` — Необязательное сообщение об ошибке или фабрика сообщений.

package/src/media/functional/functional-basic/classes/ApiErrorStorage/ApiErrorStorage.vi.mdx

@@ -0,0 +1,51 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ApiErrorStorage - Quản lý lỗi'/>
+
+# Lớp ApiErrorStorage
+
+Lớp `ApiErrorStorage` là một **Trình quản lý xử lý và nhận dạng các trạng thái lỗi API**. Nó cung cấp một kho lưu trữ tập trung cho các tiêu chí lỗi API, cho phép hệ thống xác định các lỗi cụ thể bằng cách khớp mã trạng thái phản hồi, mã lỗi từ thân JSON, phương thức yêu cầu và URL.
+
+## Các tính năng chính
+
+- **Lưu trữ tập trung** — tập hợp tất cả các mẫu lỗi API đã biết vào một nơi để xử lý nhất quán.
+- **Khớp mẫu** — xác định lỗi bằng trạng thái HTTP, mã lỗi tùy chỉnh, phương thức yêu cầu hoặc mẫu URL (bao gồm cả RegExp).
+- **Chuyển đổi cấu trúc** — chuyển đổi các lỗi mạng thô thành các mục lỗi cấp ứng dụng có cấu trúc.
+- **Xác thực tùy chỉnh** — hỗ trợ các hàm xác thực tùy chỉnh cho các kịch bản nhận dạng lỗi phức tạp.
+
+## Các phương thức
+
+### Quản lý
+
+- `add(item: ApiErrorStorageItem | ApiErrorStorageList): this` — Thêm một hoặc nhiều mục lỗi hoặc danh sách lỗi vào bộ lưu trữ nội bộ.
+
+### Nhận dạng
+
+#### `find`
+
+Tìm một mục lỗi khớp trong bộ lưu trữ bằng cách phân tích phản hồi. Nó tự động cố gắng trích xuất mã lỗi và thông báo từ thân phản hồi.
+
+**Tham số:**
+- `method: ApiMethodItem` — Phương thức HTTP được sử dụng cho yêu cầu.
+- `response: Response` — Đối tượng phản hồi Fetch API.
+
+**Trả về:** `Promise<ApiErrorStorageItem>` — Mục lỗi khớp hoặc một mục lỗi được tạo nếu không tìm thấy kết quả khớp.
+
+```javascript
+const errorItem = await errorStorage.find(ApiMethodItem.get, response);
+
+if (errorItem.code === 'USER_NOT_FOUND') {
+  // Xử lý lỗi cụ thể
+}
+```
+
+## Các loại dữ liệu (Types)
+
+### ApiErrorStorageItem
+
+- `url: string | RegExp` — Chuỗi URL hoặc biểu thức chính quy để khớp với URL yêu cầu.
+- `method: ApiMethodItem` — Phương thức HTTP bắt buộc để khớp.
+- `code?: string` — Mã lỗi tùy chọn để khớp với thân JSON.
+- `status?: number` — Mã trạng thái HTTP tùy chọn để khớp.
+- `validation?: (response: Response) => boolean` — Hàm xác thực tùy chỉnh tùy chọn.
+- `message?: string | ((response?: Response) => string)` — Thông báo lỗi tùy chọn hoặc hàm tạo thông báo.