Files
SHiNE-server/shine-UI/js/services/client-error-reporter.js
T

142 lines
6.6 KiB
JavaScript

// Единая диагностика технических ошибок UI. Без очереди и без пользовательского выключателя.
const RECENT_WINDOW_MS = 5000;
const MAX_CONTEXT_LEN = 800;
const MAX_IN_FLIGHT = 3;
let transport = null;
let inFlight = 0;
const recentFingerprints = new Map();
let notifySent = null;
let lastCapturedPayload = null;
function nowTs() { return Date.now(); }
// Диагностические строки не должны включать токены, пароли и длинные ключевые данные.
function cleanString(value, maxLen = 1000) {
if (value == null) return '';
const cleaned = String(value)
.replace(/https?:\/\/[^\s)]+/gi, (url) => {
const line = url.match(/:(\d+):(\d+)$/);
const path = url.replace(/[?#].*$/, '');
return `${path}${line && path !== url ? `:${line[1]}:${line[2]}` : ''}`;
})
.replace(/\bBearer\s+[^\s,;]+/gi, 'Bearer [REDACTED]')
.replace(/\b(password|passwd|token|secret|privateKey|sessionId|authorization|apiKey|storagePwd)\s*[:=]\s*["']?[^\s,;}&"']+/gi, '$1=[REDACTED]')
.replace(/([?&](?:token|key|password|secret|session|auth|code|signature)=[^&#\s]+)/gi, '[REDACTED_PARAM]')
.replace(/\b[A-Za-z0-9_+\/=-]{96,}\b/g, '[REDACTED_LONG_VALUE]')
.replace(/[\u0000-\u001f\u007f]+/g, ' ')
.trim();
return cleaned.length <= maxLen ? cleaned : `${cleaned.slice(0, Math.max(0, maxLen - 3))}...`;
}
function safePagePath() {
try { return cleanString(window.location?.pathname || '', 150); } catch { return ''; }
}
function safeSource(value) {
try {
const url = new URL(String(value || ''), window.location.origin);
return cleanString(`${url.origin}${url.pathname}`, 240); // без query/hash
} catch { return ''; }
}
// Только разрешённые технические поля: произвольный context может содержать DM/ключи.
function safeContext(raw) {
const obj = raw && typeof raw === 'object' ? raw : {};
const result = {};
for (const key of ['pageId', 'reasonType', 'pageProtocol', 'timeoutMs', 'code', 'status']) {
const value = obj[key];
if (typeof value === 'string' || typeof value === 'number') result[key] = cleanString(value, 80);
}
if (Array.isArray(obj.pendingOps)) {
result.pendingOps = obj.pendingOps.slice(0, 8).map((op) => cleanString(op, 48));
}
const json = JSON.stringify({ pageVisibility: document.visibilityState || '', ...result });
return cleanString(json, MAX_CONTEXT_LEN);
}
function errorId() {
const bytes = new Uint8Array(6);
if (globalThis.crypto?.getRandomValues) globalThis.crypto.getRandomValues(bytes);
else return `ERR-${nowTs().toString(16)}-${Math.random().toString(16).slice(2, 8)}`;
return `ERR-${[...bytes].map((value) => value.toString(16).padStart(2, '0')).join('').toUpperCase()}`;
}
function buildPayload(details = {}) {
const kind = cleanString(details.kind || 'client_error', 64);
const runtime = ['global_error', 'unhandled_rejection', 'page_render_failure',
'channels_thread_runtime'].includes(kind);
const originalMessage = String(details.message || details.reason || 'Unknown client error');
const type = originalMessage.match(/\b(TypeError|ReferenceError|SyntaxError|RangeError|URIError|EvalError|AggregateError)\b/);
// Произвольные исключения могут содержать приватный текст DM. Для них передаём
// только тип и адреса кадров стека, но не текст исключения/первую строку stack.
const message = runtime ? `${type?.[1] || 'RuntimeError'}: client exception` : originalMessage;
const originalStack = String(details.stack || details.error?.stack || '');
const stack = runtime ? originalStack.split('\n').slice(1).join('\n') : originalStack;
return {
errorId: errorId(),
clientVersion: cleanString(window.__SHINE_BUILD_HASH__ || '', 80),
kind,
message: cleanString(message, 500),
stack: cleanString(stack, 6000),
sourceUrl: safeSource(details.sourceUrl || details.fileName || ''),
lineNumber: Number.isFinite(details.lineNumber) ? details.lineNumber : null,
columnNumber: Number.isFinite(details.columnNumber) ? details.columnNumber : null,
route: safePagePath(),
href: window.location?.origin || '', // без query/hash и данных из URL
userAgent: cleanString(navigator.userAgent || '', 240),
clientTs: Number.isFinite(details.clientTs) ? details.clientTs : nowTs(),
requestOp: cleanString(details.requestOp || '', 64),
requestIdRef: cleanString(details.requestIdRef || '', 128),
contextJson: safeContext(details.context),
};
}
function isDuplicate(payload, key) {
const ts = nowTs();
const fingerprint = key || [payload.kind, payload.message, payload.sourceUrl,
payload.lineNumber, payload.requestOp, payload.stack.slice(0, 180)].join('|');
const prev = recentFingerprints.get(fingerprint);
for (const [name, last] of recentFingerprints) {
if (ts - last > RECENT_WINDOW_MS) recentFingerprints.delete(name);
}
if (recentFingerprints.size >= 128) recentFingerprints.delete(recentFingerprints.keys().next().value);
recentFingerprints.set(fingerprint, ts);
return prev != null && ts - prev < RECENT_WINDOW_MS;
}
export function setClientErrorTransport(fn) {
transport = typeof fn === 'function' ? fn : null;
}
export function setClientErrorSentNotifier(fn) {
notifySent = typeof fn === 'function' ? fn : null;
}
export function getLastClientErrorPayload() {
return lastCapturedPayload ? { ...lastCapturedPayload } : null;
}
export async function captureClientError(details = {}) {
const payload = buildPayload(details);
lastCapturedPayload = payload;
if (isDuplicate(payload, details.dedupeKey)) return false;
console.error('[client-error]', payload.kind, payload.message); // без исходного error/context
if (!transport || details.skipTransport === true || inFlight >= MAX_IN_FLIGHT) return false;
try {
inFlight += 1;
// Только положительное подтверждение ClientErrorLog означает запись на сервере.
const accepted = await transport(payload);
if (accepted !== true) return false;
if (notifySent) {
try { notifySent(payload); } catch { /* уведомление не должно ломать диагностику */ }
}
return true;
} catch {
// Ошибка отправки не создаёт новый отчёт и не запускает повторную отправку.
return false;
} finally {
inFlight -= 1;
}
}