Справочник конфигурации
Опции верхнего уровня
| Опция | Тип | По умолчанию | Описание |
|---|---|---|---|
enabled | boolean | true | Главный переключатель вкл/выкл |
maxLogs | number | 1000 | Максимум записей, хранимых в памяти. Самые старые вытесняются при достижении лимита |
devOnly | boolean | false | Когда true, плагин бездействует в продакшене (import.meta.env.PROD) |
persistToStorage | boolean | false | Сохранять логи в localStorage и восстанавливать их при перезагрузке страницы |
router | Router | — | Инстанс Vue Router. Требуется для обогащения контекстом маршрута (см. Интеграция с Vue Router) |
enrichWithRoute | boolean | false | Прикреплять router.currentRoute.value.fullPath к каждой записи лога как entry.route |
interceptors
| Опция | Тип | По умолчанию | Описание |
|---|---|---|---|
interceptors.fetch | boolean | true | Перехватывать window.fetch |
interceptors.xhr | boolean | true | Перехватывать XMLHttpRequest |
interceptors.websocket | boolean | true | Перехватывать WebSocket |
interceptors.sse | boolean | true | Перехватывать EventSource (SSE) |
filters
Предварительно фильтрует события перед сохранением. Несовпадающие записи отбрасываются.
| Опция | Тип | Описание |
|---|---|---|
filters.urlPattern | RegExp | Сохранять только записи, чей URL совпадает |
filters.excludeUrlPattern | RegExp | Отбрасывать записи, чей URL совпадает |
filters.methods | string[] | Сохранять только записи с этими HTTP-методами (например, ['GET','POST']) |
filters.statusCodes | number[] | Сохранять только записи с этими точными кодами статуса |
filters.bodySizeThreshold | number | Сохранять только записи, чьё тело не менее указанного числа байт |
sanitization
| Опция | Тип | Описание |
|---|---|---|
sanitization.sensitiveHeaders | string[] | Имена заголовков для полного редактирования ([REDACTED]). Объединяются со встроенными значениями по умолчанию |
sanitization.sensitiveFields | string[] | Имена полей тела для полного удаления. Объединяются со встроенными значениями по умолчанию |
sanitization.maskFields | string[] | Имена полей тела для частичного маскирования (например, us***@example.com). Объединяются со встроенными значениями по умолчанию |
metrics
| Опция | Тип | По умолчанию | Описание |
|---|---|---|---|
metrics.calculateTTFB | boolean | true | Отслеживать Time To First Byte для HTTP-запросов |
metrics.trackRetries | boolean | true | Увеличивать metadata.retryCount при повторных запросах к одному URL |
callbacks
| Опция | Тип | Описание |
|---|---|---|
callbacks.onLog | (entry: UnifiedLogEntry) => void | Вызывается после сохранения каждой записи лога |
callbacks.onError | (error: Error) => void | Вызывается при возникновении внутренней ошибки плагина |
callbacks.onFlush | (logs: UnifiedLogEntry[]) => void | Вызывается после clear() с удалёнными записями |
ui
Управляет встроенной панелью <NetworkDebugger>. Эти значения действуют как значения по умолчанию и могут быть переопределены пропами компонента.
| Опция | Тип | По умолчанию | Описание |
|---|---|---|---|
ui.hotkey | string | 'd' | Символ клавиши для шортката переключения |
ui.hotkeyModifiers.ctrl | boolean | true | Требовать клавишу Ctrl |
ui.hotkeyModifiers.alt | boolean | — | Требовать клавишу Alt |
ui.hotkeyModifiers.shift | boolean | true | Требовать клавишу Shift |
ui.hotkeyModifiers.meta | boolean | — | Требовать клавишу Meta (⌘ / Win) |