Перейти к основному содержимому
Версия: Next

Interface: ErrorEventPayload

Структура данных события об ошибке редактора.

Содержит подробную информацию об ошибке для логирования, отладки и информирования пользователя.

Remarks

Содержит:

  • code — числовой код ошибки для программной обработки
  • error — текстовое описание для пользователя или логов
  • stack — стэк-трейс для отладки (опционально)

Использование:

editorApi.events.subscribe('editorError', (payload) => {
console.error(`Ошибка ${payload.code}: ${payload.error}`);
if (payload.stack) console.error(payload.stack);
});

Properties

code

code: number

Числовой код ошибки, уникально идентифицирующий тип проблемы.

Remarks

Используется для:

  • Программной обработки разных типов ошибок
  • Локализации сообщений об ошибках
  • Сортировки и группировки в логах

Example

editorApi.events.subscribe('editorError', (payload) => {
switch (payload.code) {
case 2000:
editorApi.ui.toasts.showToast({ id, type: 'error', content: 'Не удалось сохранить документ' });
break;
case 3000:
editorApi.ui.toasts.showToast({ id, content: 'Проблемы с синхронизацией' });
break;
}
});

error

error: string

Текстовое описание ошибки.

Remarks

Содержит:

  • Понятное описание что произошло
  • Детали ошибки для логирования
  • Информацию для пользователя или разработчика

Примеры:

  • "Failed to save document: Network timeout"
  • "Synchronization error: Conflicting changes detected"
  • "Document initialization failed: Invalid format"

Example

editorApi.events.subscribe('editorError', (payload) => {
console.error(`Ошибка редактора: ${payload.error}`);
editorApi.ui.toasts.showToast({ id, type: 'error', content: payload.error });
});

stack?

optional stack: string

Стэк-трейс ошибки (опционально).

Remarks

Содержит:

  • Последовательность вызовов функций, приведших к ошибке
  • Информацию о файлах и номерах строк (в режиме отладки)
  • Полезен для диагностики и исправления проблем

Когда используется:

  • Отладка в режиме разработки
  • Отправка на сервер для анализа
  • Логирование критических ошибок

Default

undefined

Example

editorApi.events.subscribe('editorError', (payload) => {
if (payload.stack) {
console.error('Stack trace:', payload.stack);
// Отправить на сервер для анализа
reportError(payload);
}
});