jQuery Academy · 课时

处理 AJAX 错误与成功响应

使用 .fail() 和 .always() 回调实现可靠的错误处理机制,并使用 .done() 处理成功获取的数据,构建更具韧性的应用。

第 2 / 3 课11 个步骤

处理 AJAX 错误与成功响应 是 CoddyKit 上的免费 jQuery Academy 课时。 这是第 2 节课,共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 jQuery Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 jQuery Academy 课程共包含 3 节课。

处理异步结果

发起 AJAX 请求时,这是一个异步操作。这意味着代码不会等待服务器的响应,而是继续执行其他任务。

为了处理服务器的回复(或没有回复的情况),jQuery 提供了称为回调函数的特殊方法。这些函数只会在特定事件发生时运行,例如成功或失败。

一切顺利时

.done()回调函数用于处理成功的 AJAX 请求。当服务器返回表示成功的状态码(通常为 200-299)时,它就会执行。

  • 它会接收服务器返回的数据。
  • 这是使用最新信息更新用户界面的理想位置。

显示成功获取的数据

让我们获取一些数据,并在请求成功时将其显示出来。请注意,.done()是如何链式调用在$.ajax()调用之后的。

$(document).ready(function() {
  $.ajax({
    url: "https://jsonplaceholder.typicode.com/posts/1",
    method: "GET"
  })
  .done(function(data) {
    console.log("Success! Data received:");
    console.log(data.title); // Access a property
    $('body').append('<p>Post Title: ' + data.title + '</p>');
  });
});

出现问题时

但是,如果服务器无法满足您的请求,该怎么办呢?这时就要使用.fail()回调函数了。当 AJAX 请求遇到错误时,例如 404(未找到)或 500(服务器错误),它就会运行。

  • 它可以帮助您告知用户相关情况或记录问题。
  • 它会接收有关错误的详细信息。

响应失败

让我们尝试从一个不存在的网址获取数据。.fail()回调函数会捕获错误并记录其详细信息。

$(document).ready(function() {
  $.ajax({
    url: "https://jsonplaceholder.typicode.com/nonexistent", // This URL will fail
    method: "GET"
  })
  .done(function(data) {
    console.log("This won't run on error.");
  })
  .fail(function(jqXHR, textStatus, errorThrown) {
    console.log("Error! Status: " + textStatus);
    console.log("HTTP Error: " + errorThrown);
    $('body').append('<p>Error fetching data!</p>');
    $('body').append('<p>Status: ' + textStatus + '</p>');
  });
});

解析错误参数

.fail()回调函数提供了三个有用的参数,帮助您了解发生了什么问题:

  • jqXHR:jQuery XMLHttpRequest 对象,提供底层详细信息。
  • textStatus:描述错误类型的字符串(例如“timeout”“error”“abort”)。
  • errorThrown:HTTP 状态文本(例如 404 对应的“Not Found”)。

请使用这些信息向用户提供具体的反馈。

无论如何都会运行

有时,无论 AJAX 请求成功还是失败,您都需要执行某项操作。这正是.always()回调函数的作用。

  • 它总是在.done()或.fail()其中之一执行后运行。
  • 它非常适合执行清理任务,例如隐藏加载指示器或重新启用按钮。

执行清理操作

让我们在前面的示例中添加.always()。我们将模拟加载状态,并确保无论请求成功还是失败,该状态都会被移除。

$(document).ready(function() {
  $('body').append('<p id="status">Loading data...</p>'); // Simulate loading
  $.ajax({
    url: "https://jsonplaceholder.typicode.com/posts/1", // Try changing to 'nonexistent' to see fail+always
    method: "GET"
  })
  .done(function(data) {
    console.log("Success! Data: " + data.title);
    $('#status').text('Data loaded successfully!');
  })
  .fail(function(jqXHR, textStatus, errorThrown) {
    console.log("Failed! " + textStatus);
    $('#status').text('Failed to load data!');
  })
  .always(function() {
    console.log("Request finished (success or failure).");
    // This could be where you hide a spinner or re-enable a button
    $('#status').append(' (Finished)');
  });
});

组织回调函数

jQuery 的 AJAX 方法会返回一个类似 Promise 的对象,因此您可以直接链式调用.done()、.fail()和.always()方法。

这种链式调用能让代码更简洁、更易读,并清晰地分隔成功、错误和最终处理逻辑。

检验您的知识

请思考下面的 jQuery AJAX 请求:


$.ajax({
  url: "/api/data",
  method: "GET"
})
.done(function() {
  console.log("A");
})
.fail(function() {
  console.log("B");
})
.always(function() {
  console.log("C");
});

如果服务器返回 404 Not Found 错误,控制台会输出什么内容?

总结 AJAX 处理

您已经掌握了实现可靠 AJAX 处理所需的核心回调函数:

  • .done():用于处理成功的响应。
  • .fail():用于处理错误。
  • .always():用于执行无论结果如何都应运行的操作。

使用这些回调函数,即使网络交互没有按计划进行,您的应用也能妥善处理,从而为用户提供更好的体验!

免费开始

用 AI 导师学习 JavaScript — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
22
课程
48

常见问题解答

「处理 AJAX 错误与成功响应」课时是免费的吗?

是的 — 「处理 AJAX 错误与成功响应」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 jQuery Academy 课程的其余内容,请升级到 CoddyKit PRO。 jQuery Academy 课程共包含 3 节课。

「处理 AJAX 错误与成功响应」这节课中我会学到什么?

使用 .fail() 和 .always() 回调实现可靠的错误处理机制,并使用 .done() 处理成功获取的数据,构建更具韧性的应用。 你通过在浏览器中直接运行的动手代码来练习 jQuery Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 jQuery Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 jQuery Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 3 节。

「处理 AJAX 错误与成功响应」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 jQuery Academy 课中编写并运行代码吗?

能。每节 jQuery Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 高效配置 AJAX 请求
  2. 处理 AJAX 错误与成功响应
  3. 跨域 AJAX(CORS/JSONP)
← 返回 jQuery Academy