精准捕获前端错误与异常：优化应用的可靠性与用户体验

对前端错误进行仔细监听不仅使得开发团队能够迅速响应和妥善处理问题，同时也有助于提升应用的可靠性和用户满意度。这种专业方法不仅为团队提供了宝贵的调试信息，同时也为用户创造了稳定、流畅的使用体验。

在本文中，我们将深入探讨如何对这三个关键问题如静态资源加载问题、JS执行错误和AJAX请求错误进行有效监听，以确保前端应用的高质量交付。

监控和处理前端静态资源加载错误

使用 performance API 监控资源加载时间

在现代 Web 应用中，前端性能是至关重要的一环。通过 performance API，我们可以深入了解各个静态资源的加载时间，从而针对慢加载资源采取优化措施。

window.addEventListener('load', function() {
  const resources = performance.getEntriesByType('resource');
  const slowResourceThreshold = 1000; // 阈值设定为1000ms
  const slowResources = resources.filter(resource => resource.duration > slowResourceThreshold);

  slowResources.forEach(resource => {
    console.log(`慢加载资源：${resource.name}，加载时间：${resource.duration}ms`);
    // 可以进行进一步的处理，例如加载备用资源或分析优化策略
  });
});

上面的代码在页面加载后，通过遍历来监控资源的加载时间，并识别加载超过阈值的满资源。

对代码进行封装：

// 获取所有资源的列表
const resources = performance.getEntriesByType('resource'); 

// 遍历列表判断资源加载时间 
resources.forEach(item => {
  if (item.duration > 1000) { 
    // 超过1000ms判定为慢资源
    reportSlowResource(item); 
  }
});

// 上报慢资源信息
function reportSlowResource(resource) {
  const data = {
    name: resource.name,
    duration: resource.duration
  };
  
  // 上报到监控系统
  report(data); 
}

这样我们可以明确哪些资源的加载特别慢,进行针对性优化。

监听资源加载错误事件

通过监听资源加载错误事件，我们可以实时捕获资源加载失败的情况，从而快速采取应对措施。

window.addEventListener('error', function(event) {
  if (event.target.tagName === 'SCRIPT' || event.target.tagName === 'LINK' || event.target.tagName === 'IMG') {
    console.log(`静态资源加载错误：${event.target.src || event.target.href}`);
    // 可以执行适当的错误处理，如加载备用资源或展示错误信息
  }
});

此代码段添加了一个监听器，用于捕获所有的静态资源加载错误。通过判断错误事件的目标元素的标签名，确定错误类型是脚本、链接还是图片。如果错误发生在这些特定类型的资源上（SCRIPT、LINK、IMG），则会输出错误信息，并可以在适当的情况下执行错误处理，例如加载备用资源或展示错误信息。

总体来说，这段代码的目标是捕获并处理静态资源加载错误，不仅能够在控制台输出错误信息，还可以通过上报函数将错误信息传递到监控系统，以便分析和处理。它能帮助开发团队更好地应对前端资源加载问题，提升用户体验和应用稳定性。

统计网络请求失败次数

对于网络请求异常，我们可以通过统计请求失败次数来监控网络环境的稳定性。

let reqFailedCount = 0;

function ajaxRequest(url) {
  const xhr = new XMLHttpRequest();

  xhr.onerror = () => {
    reqFailedCount++;
    if (reqFailedCount > 10) {
      reportNetWorkError();
    }
  };

  xhr.open('GET', url);
  xhr.send();
}

function reportNetWorkError() {
  // 捕获网络请求失败次数异常
  // 进行上报或报警
}

这部分代码是在每次请求失败时，通过递增reqFailedCount变量来记录失败的次数，并在失败次数超过阈值时调用reportNetWorkError函数进行错误上报或报警。这是一种基于每次请求的网络请求失败监控机制。

主动检测资源加载失败

除了 passively 监听错误事件，我们还可以主动测试资源加载错误的处理逻辑是否正确。

function testResourceLoading() {
  const testImage = new Image();
  testImage.src = 'nonexistent-image.jpg';

  testImage.onload = function() {
    console.log('资源加载正常');
  };

  testImage.onerror = function() {
    console.log('资源加载异常，可能是错误处理逻辑存在问题');
    // 可以检查错误处理逻辑是否生效
  };
}

// 调用 testResourceLoading 进行主动测试

监控和处理 JavaScript 执行错误

监听 window 的 error 事件

JavaScript 执行错误是前端开发中常见的问题，使用 error 事件来监听未被 try-catch 捕获的错误。

window.addEventListener('error', function(event) {
  console.log(`JavaScript 执行错误：${event.message}，位置：${event.filename}:${event.lineno}:${event.colno}`);
  // 可以执行错误处理，如上报错误或提供友好的错误提示
});

这段代码使用了window.addEventListener来监听全局的错误事件。当页面中发生JavaScript错误时，这个监听器会被触发。

在事件处理函数中，通过event对象可以获得关于错误的信息，如错误信息、出错的文件名和出错代码的行号。然后，错误事件被传递给reportJSError函数，用于将错误信息上报给监控系统或进行其他处理。

这种方式通过监听全局的错误事件，可以捕获到未被try-catch等机制捕获的JavaScript执行错误。可以获取到错误的具体信息，如错误信息、错误文件名和行号，有助于定位和解决问题。

但是，这种监听方式无法捕获异步代码（如Promise内部的错误），因此在面对异步操作时，可能需要配合使用专业的错误监控SDK。

总体来说，这段代码提供了一种捕获全局JavaScript错误的方法，有助于及时发现和处理未被捕获的错误，提升应用的稳定性和用户体验。

使用错误监控 SDK

为了更精确和完善地监控 JavaScript 执行错误，可以引入专业的错误监控 SDK，如 Sentry 或 Rollbar。

// 在应用初始化时配置错误监控 SDK
Sentry.init({
  dsn: 'YOUR_DSN_KEY',
  // 更多配置项...
});

// 在代码中使用错误监控 SDK 上报错误
try {
  // 有可能抛出异常的代码
} catch (error) {
  Sentry.captureException(error);
}

集成 Sentry 错误监控 SDK 可以方便地捕获各种类型的错误和异常，包括 JavaScript 错误、未捕获异常等。

Sentry.captureException方法可以捕获异常的详细信息，包括错误堆栈、文件和行号等，帮助快速定位问题。

合理进行错误边界处理

即使有监控系统，错误边界处理仍然不可或缺。使用 try-catch 来保护代码段，避免错误影响到整个应用。

function loadData() {
  try {
    // 调用接口加载数据 
    $.get('/data', data => {
      // ...处理数据
    });
  } catch (error) {
    // 数据加载出错时的降级处理
    showFallbackData();
  }
} 

function showFallbackData() {
  // 显示缓存或mock的数据
}

loadData函数封装了数据加载的过程，它通过尝试调用接口来获取数据。如果数据加载过程中出现异常，即使捕获到错误，也会执行showFallbackData函数来展示备用的数据。

这种设计适用于在复杂网络环境中，当数据加载遇到问题时能够提供恰当的反馈。例如，可以在数据加载失败时，展示预先准备的缓存数据或者模拟数据，从而确保用户仍然能够获得有价值的信息。

监控和处理 AJAX 请求错误

统一的请求错误处理函数

在处理 AJAX 请求时，提供一个统一的错误处理函数，确保错误可以被集中处理。

function handleAjaxError(jqXHR, textStatus, errorThrown) {
  console.log(`AJAX 请求错误：${textStatus}`);
  // 可以根据不同的 textStatus 执行不同的处理逻辑
}

$.ajaxSetup({
  error: handleAjaxError,
});

// 所有的 AJAX 请求都会调用 handleAjaxError 进行错误处理

这种设计适用于项目中存在多个 AJAX 请求的情况，能够帮助在出现错误时保持代码的优雅和一致性。通过全局设置错误处理函数，开发者能够集中精力处理错误逻辑，从而提高效率并降低代码重复性。

根据状态码分类处理

根据 AJAX 请求的 HTTP 状态码，执行不同的错误处理逻辑。

function handleAjaxError(jqXHR, textStatus, errorThrown) {
  if (jqXHR.status === 401) {
    console.log('未授权，跳转到登录页');
  } else if (jqXHR.status === 404) {
    console.log('请求接口不存在');
  } else if (jqXHR.status === 500) {
    console.log('服务器错误，可以重试');
  }
  // 更多状态码处理...
}

失败请求重试机制

在网络不稳定的情况下，可以实现一个简单的失败请求重试机制，提高请求成功率。

let retryCount = 0;
const maxRetryCount = 3;

function retryAjaxRequest(url, options) {
  $.ajax(url, options)
    .fail(function() {
      if (retryCount < maxRetryCount) {
        retryCount++;
        retryAjaxRequest(url, options); // 重试请求
      }
    });
}

retryAjaxRequest('https://api.example.com/data', { method: 'GET' });

代码中的 retryAjaxRequest 函数封装了一个 AJAX 请求，当请求失败时，它会检查 retryCount（重试计数）是否小于设定的 maxRetryCount（最大重试次数）。如果计数允许，它会递增 retryCount，然后再次调用自身进行重试请求。

可以确保在请求失败的情况下，自动进行最多 maxRetryCount 次的重试，从而提高了数据的可靠性。这对于确保数据传输的成功非常有用，尤其是在不稳定的网络环境中。

异常请求缓存处理

对于某些非核心业务的 AJAX 请求，可以考虑在请求失败时返回缓存数据，提升用户体验。

let cacheData = null;

function fetchCachedData() {
  if (cacheData) {
    return Promise.resolve(cacheData);
  } else {
    return $.ajax('https://api.example.com/cached-data', { method: 'GET' })
      .done(function(data) {
        cacheData = data;
      })
      .fail(function() {
        console.log('缓存数据请求失败，返回旧的缓存数据');
      });
  }
}

// 使用 fetchCachedData 获取缓存数据
fetchCachedData().then(function(data) {
  console.log('获取到缓存数据：', data);
});

上面代码的作用：

• 智能缓存数据获取：在函数 fetchCachedData 中，代码首先检查是否已经存在缓存的数据。如果存在，它会立即将缓存数据通过 Promise 返回。这种机制可以在请求新数据失败的情况下，智能地提供已有的缓存数据，从而避免数据不可用导致的问题。

• 网络请求失败降级：当尝试获取新数据的请求失败时，代码并不终止。相反，它会记录请求失败的消息，并返回之前缓存的数据。这种健壮的降级机制确保用户在网络不稳定或请求失败的情况下仍然能够获得旧的可用数据，维护了应用的可用性。

• 用户体验优化：通过提供缓存数据的机制，即使网络请求失败，用户也不会受到直接影响。他们仍然能够获得过去的数据，并且无需知道请求失败的细节。这种方式有助于提升用户体验，减少用户因数据不可用而受到的困扰。

• 减轻服务器压力：通过在请求失败时返回缓存数据，可以减轻服务器的负担。如果多个用户在同一时间请求数据，并且请求都失败，服务器不会面临频繁的请求压力，因为部分用户可以使用缓存数据。

请求队列顺序处理

为避免大量请求同时发起导致服务压力激增，可以实现一个请求队列，顺序地发出请求。

const requestQueue = [];
let isProcessing = false;

function enqueueRequest(url, options) {
  return new Promise((resolve, reject) => {
    requestQueue.push({
      url,
      options,
      resolve,
      reject,
    });
    if (!isProcessing) {
      processQueue();
    }
  });
}

async function processQueue() {
  isProcessing = true;
  while (requestQueue.length > 0) {
    const { url, options, resolve, reject } = requestQueue.shift();
    try {
      const result = await $.ajax(url, options);
      resolve(result);
    } catch (error) {
      reject(error);
    }
  }
  isProcessing = false;
}

// 使用 enqueueRequest 发起请求
enqueueRequest('https://api.example.com/data', { method: 'GET' })
  .then(function(data) {
    console.log('请求成功：', data);
  })
  .catch(function(error) {
    console.log('请求失败：', error);
  });

段代码实现了一个精巧的请求队列管理系统。它的主要目的是在高并发情况下，以有序的方式处理请求，保证每个请求都在适当的时机被调用并获得响应，从而避免请求的混乱和交叉。

1. 请求队列控制：通过 enqueueRequest 函数，请求被有序地加入了一个请求队列中。每个请求都包含了其相关参数和 Promise 的解决与拒绝函数。这种方法确保了请求的有序性，避免了并发请求引发的竞争条件和错位问题。

2. 逐个处理请求：processQueue 函数负责逐个处理请求队列中的请求。通过异步的方式，它依次处理每个请求，等待一个请求成功后再处理下一个请求。这种方式保证了请求的顺序执行，防止了多个请求同时触发并导致数据交叉的情况。

3. 异步并发安全：代码使用异步操作来处理请求队列，确保了在高并发场景下的安全执行。同时，它通过合理地利用异步的特性，避免了阻塞主线程，从而保持了应用的响应性。

4. 错误处理机制：对于每个请求，无论成功还是失败，都会调用相应的解决或拒绝函数。这保证了无论请求的结果如何，都能够得到适当的处理，避免了未处理的错误或悬挂的 Promise。

这种方法适用于需要确保请求顺序的场景，如需要按顺序加载资源或执行一系列关联操作的情况。

总结

针对静态资源加载错误，通过监控资源加载时间和监听资源加载错误事件，我们可以及时发现资源加载问题，并做出优化处理，从而提升页面性能和用户体验。同时，合理进行请求失败次数的统计和主动测试，能够有效捕获网络环境异常，进一步增强前端应用的稳定性。

对于 JavaScript 执行错误，通过监听 window 的 error 事件和引入错误监控 SDK，我们能够准确捕获并上报各类执行错误，从而迅速发现并解决潜在问题。合理的错误边界处理，能够隔离错误，避免错误波及到整个应用。

在处理 AJAX 请求错误方面，统一的请求错误处理函数、根据状态码分类处理、失败请求重试机制以及请求队列顺序处理，都能够提高请求成功率，并且在网络不稳定的情况下，保障数据的正常获取。

综上所述，通过科学合理地监控和处理前端错误，我们可以提升应用的健壮性和用户体验，确保应用在各种异常情况下依然能够稳定运行。

一川说

觉得文章不错的读者，不妨点个关注，收藏起来上班摸鱼的时候品尝。

欢迎关注笔者公众号「宇宙一码平川」，助你技术路上一码平川。