如何在 jQuery 的 ajaxComplete 中忽略查询参数匹配 URL

本文详细讲解在使用 jQuery 的 ajaxComplete 事件时，如何有效匹配带有动态查询字符串（例如 ?_=1324346569）的 AJAX 请求 URL。核心解决方案是采用子字符串包含检测或路径名解析，而非全等匹配，从而避免因时间戳等随机缓存参数导致的匹配失败问题。

在 Web 开发中处理 AJAX 请求时，URL 匹配是一个常见且容易被忽视的难点。特别是在 Shopify 等电商平台或使用某些前端框架时，像 `/cart.js` 这样的资源路径，经常会被自动附加一串用于防止缓存（Cache Busting）的随机查询参数，例如 `?_=1698765432`。此时，如果开发者仍然使用严格相等运算符（`===`）进行判断，例如 `settings.url === "/cart.js"`，结果将永远是 `false`，导致后续的回调逻辑无法按预期执行。

那么，如何正确且高效地解决这个问题呢？关键在于改变匹配策略：放弃精确的字符串全等比较，转而检查请求的 URL 是否以目标路径开头，或者包含了该核心路径片段。其中，`String.prototype.includes()` 方法因其语法简洁、意图清晰而成为首选方案，其浏览器兼容性良好（支持 IE9+），足以应对绝大多数现代 Web 项目。

$(document).ajaxComplete(function(event, xhr, settings) {
    if (settings.url.includes("/cart.js")) {
        console.log("✅ 成功捕获 /cart.js 请求（忽略查询参数）");
        // 在此处执行购物车数据更新、UI 同步等相关操作
    }
});

然而，在实际应用时，有几个重要的注意事项和优化方案需要了解：

• 避免误匹配：`includes()` 方法执行的是子串匹配，这意味着类似 `/my-cart.js` 或 `/checkout/cart.js` 的路径也会被匹配到。若对匹配精度有极高要求，推荐使用更精确的 `URL` API 来解析路径名（pathname），或使用正则表达式进行锚定匹配：

  const url = new URL(settings.url, window.location.origin);
  if (url.pathname === "/cart.js") {
      console.log("✅ 通过 pathname 实现精确匹配，完全忽略查询字符串和哈希片段");
  }

• 兼容性处理：如果项目需要支持 Internet Explorer 8 等旧版本浏览器，可以使用 `indexOf() !== -1` 作为 `includes()` 的替代方案，实现相同的功能。
• 性能优化建议：`ajaxComplete` 是一个全局事件监听器，所有通过 jQuery 发出的 AJAX 请求完成时都会触发它。在 AJAX 请求频繁的页面中，建议在回调函数内部尽早进行有效的条件判断并退出，以避免不必要的性能开销。对于新项目，也可以考虑采用更现代的 `fetch API` 配合拦截器（Interceptors）和 `AbortController` 等方案进行替代。

总结来说，针对带有动态查询参数的 AJAX 请求 URL 匹配问题，采用 `settings.url.includes("/cart.js")` 是一种在代码简洁性、可读性和实用性之间取得良好平衡的解决方案。它能有效规避缓存参数带来的干扰，确保您的回调逻辑在正确的时机被稳定触发。