jQuery.post()

这是一个简写 Ajax 函数，等同于

$.ajax({
  type: "POST",
  url: url,
  data: data,
  success: success,
  dataType: dataType
});

success 回调函数会接收返回的数据，该数据将是 XML 根元素或文本字符串，具体取决于响应的 MIME 类型。还会接收响应的文本状态。

从 jQuery 1.5 开始，success 回调函数还会接收一个 “jqXHR 对象” (在 jQuery 1.4 中，它接收 XMLHttpRequest 对象)。

大多数实现会指定一个成功处理程序

$.post( "ajax/test.html", function( data ) {
  $( ".result" ).html( data );
});

此示例获取请求的 HTML 片段并将其插入页面。

使用 POST 获取的页面永远不会被缓存，因此 jQuery.ajaxSetup() 中的 cache 和 ifModified 选项对这些请求无效。

jqXHR 对象

从 jQuery 1.5 开始，所有 jQuery 的 Ajax 方法都返回 XMLHTTPRequest 对象的超集。此 jQuery XHR 对象（或 $.post() 返回的“jqXHR”）实现了 Promise 接口，使其具有 Promise 的所有属性、方法和行为（有关更多信息，请参阅 Deferred object）。jqXHR.done()（用于成功）、jqXHR.fail()（用于错误）和 jqXHR.always()（用于完成，无论成功还是错误；在 jQuery 1.6 中添加）方法接受一个函数参数，该函数在请求终止时被调用。有关此函数接收的参数信息，请参阅 $.ajax() 文档的 jqXHR Object 部分。

Promise 接口还允许 jQuery 的 Ajax 方法，包括 $.get()，在单个请求上链式调用多个 .done()、.fail() 和 .always() 回调，甚至可以在请求可能已完成之后分配这些回调。如果请求已完成，则立即触发回调。

// Assign handlers immediately after making the request,
// and remember the jqxhr object for this request
var jqxhr = $.post( "example.php", function() {
  alert( "success" );
})
  .done(function() {
    alert( "second success" );
  })
  .fail(function() {
    alert( "error" );
  })
  .always(function() {
    alert( "finished" );
  });
 
// Perform other work here ...
 
// Set another completion function for the request above
jqxhr.always(function() {
  alert( "second finished" );
});

废弃通知

jqXHR.success()、jqXHR.error() 和 jqXHR.complete() 回调方法自 jQuery 3.0 起已移除。你可以改用 jqXHR.done()、jqXHR.fail() 和 jqXHR.always()。

• 由于浏览器安全限制，大多数“Ajax”请求都受 同源策略的约束；请求无法成功从不同的域、子域、端口或协议检索数据。
• 如果使用 jQuery.post() 的请求返回了错误代码，它将静默失败，除非脚本还调用了全局 ajaxError 事件。或者，从 jQuery 1.5 开始，jQuery.post() 返回的 jqXHR 对象的 .error() 方法也可用于错误处理。