答案:前端日志监控通过捕获错误、性能与行为数据并上报,提升应用稳定性。1. 定义错误、性能、行为和自定义四类日志;2. 利用全局事件监听捕获JS错误、Promise异常及资源加载失败;3. 使用Performance API采集页面加载、渲染等性能指标;4. 通过立即上报严重错误、批量发送低优先级日志,并结合sendBeacon确保页面卸载时日志不丢失,实现高效可靠的数据收集。

前端日志记录与上报是提升应用稳定性和用户体验的重要手段。通过 JavaScript 实现日志监控,可以捕获错误、性能数据和用户行为,帮助开发者快速定位问题并优化产品。以下是实现这一功能的核心思路与代码示例。
1. 日志类型定义
明确需要收集的日志类型,有助于后续分析和处理:
- 错误日志:JavaScript 运行时错误、资源加载失败、Promise 异常等
- 性能日志:页面加载时间、首屏渲染、资源耗时等(利用 Performance API)
- 行为日志:关键按钮点击、路由跳转、用户停留时长等
- 自定义日志:业务逻辑中的调试信息或状态标记
2. 全局异常捕获
使用全局事件监听器捕获未处理的异常和错误:
// 捕获 JS 运行时错误
window.addEventListener('error', (event) => {
const log = {
type: 'error',
message: event.message,
filename: event.filename,
lineno: event.lineno,
colno: event.colno,
stack: event.error?.stack || '',
url: location.href,
timestamp: Date.now()
};
reportLog(log);
});
<p>// 捕获未处理的 Promise 错误
window.addEventListener('unhandledrejection', (event) => {
const log = {
type: 'promise_rejection',
reason: event.reason?.message || String(event.reason),
stack: event.reason?.stack || '',
url: location.href,
timestamp: Date.now()
};
reportLog(log);
});</p><p>// 资源加载失败(如 img、script)
window.addEventListener('error', (event) => {
const target = event.target;
if (target instanceof HTMLImageElement ||
target instanceof HTMLScriptElement ||
target instanceof HTMLLinkElement) {
const log = {
type: 'resource_error',
tagName: target.tagName,
src: target.src || target.href,
outerHTML: target.outerHTML,
url: location.href,
timestamp: Date.now()
};
reportLog(log);
}
}, true);</p>3. 性能数据采集
利用 Performance API 获取关键性能指标:
立即学习“Java免费学习笔记(深入)”;
function collectPerformance() {
const perfData = performance.getEntriesByType('navigation')[0];
if (!perfData) return;
<p>const log = {
type: 'performance',
loadTime: perfData.loadEventEnd - perfData.fetchStart,
domReady: perfData.domContentLoadedEventEnd - perfData.fetchStart,
firstPaint: performance.getEntriesByName('first-paint')[0]?.startTime,
firstContentfulPaint: performance.getEntriesByName('first-contentful-paint')[0]?.startTime,
url: location.href,
timestamp: Date.now()
};
reportLog(log);
}</p><p>// 页面加载完成后上报
window.addEventListener('load', collectPerformance);</p>4. 日志上报策略
避免频繁请求,合理控制上报频率和时机:
- 立即上报严重错误(如崩溃类错误)
- 批量上报低优先级日志(定时或达到一定数量后)
- 考虑用户网络环境(避免在弱网下频繁发送)
- 使用 sendBeacon 确保页面卸载时日志不丢失
let logQueue = [];
<p>function reportLog(log) {
logQueue.push(log);</p><p>// 立即上报致命错误
if (log.type === 'error' || log.type === 'promise_rejection') {
flushLogs();
}</p><p>// 防抖批量上报
clearTimeout(reportLog.timer);
reportLog.timer = setTimeout(flushLogs, 3000);
}</p><p>function flushLogs() {
if (logQueue.length === 0) return;</p><p>const logsToSend = logQueue.splice(0, logQueue.length);</p><p>// 使用 sendBeacon 在页面关闭时也能发送
if (navigator.sendBeacon) {
const blob = new Blob([JSON.stringify({ logs: logsToSend })], { type: 'application/json' });
navigator.sendBeacon('/api/log', blob);
} else {
// fallback 到 fetch
fetch('/api/log', {
method: 'POST',
body: JSON.stringify({ logs: logsToSend }),
keepalive: true // 保持连接,确保发送成功
}).catch(() => {});
}
}</p>基本上就这些。通过合理设计日志结构、全面捕获异常、结合性能采集和可靠上报机制,就能构建一个轻量但实用的前端监控系统。关键是平衡数据完整性与性能开销,避免影响主业务流程。











