jQuery 的 $.post() 方法详细说明

jQuery 的 $.post() 方法用于发送 HTTP POST 请求到服务器,并返回响应数据。

语法

jQuery.post(url,data,success(data, textStatus, jqXHR),dataType)
参数 描述
url 必需。规定把请求发送到哪个 URL。
data 可选。映射或字符串值。规定连同请求发送到服务器的数据。
success(data, textStatus, jqXHR) 可选。请求成功时执行的回调函数。
dataType

可选。规定预期的服务器响应的数据类型。

默认执行智能判断(xml、json、script 或 html)。

示例:

javascript
// 发送一个请求,并将请求数据指定为一个对象
$.post("https://example.com/api/user", {
  name: "John Doe",
  age: 30
}, function(data, textStatus) {
  // 处理响应数据
});

// 发送一个请求,并将请求数据指定为一个字符串
$.post("https://example.com/api/login", "username=johndoe&password=password", function(data, textStatus) {
  // 处理响应数据
});

// 发送一个请求,并将请求数据指定为一个数组
$.post("https://example.com/api/products", [1, 2, 3], function(data, textStatus) {
  // 处理响应数据
});

注意:

  • $.post() 方法与 jQuery 的 $.ajax() 方法类似,但 $.post() 方法是 $.ajax() 方法的简化写法。
  • $.post() 方法的 success 参数指定的回调函数会在请求成功时执行。如果请求失败,则会调用 $.ajax() 方法的 error 参数指定的回调函数。

更多实例

例子 1

请求 test.php 页面,并一起发送一些额外的数据(同时仍然忽略返回值):

$.post("test.php", { name: "Bill", time: "2pm" } );

例子 2

向服务器传递数据数组(同时仍然忽略返回值):

$.post("test.php", { 'choices[]': ["Jon", "Susan"] });

例子 3

使用 ajax 请求发送表单数据:

$.post("test.php", $("#testform").serialize());

例子 4

输出来自请求页面 test.php 的结果(HTML 或 XML,取决于所返回的内容):

$.post("test.php", function(data){
   alert("Data Loaded: " + data);
 });

例子 5

向页面 test.php 发送数据,并输出结果(HTML 或 XML,取决于所返回的内容):

$.post("test.php", { name: "Bill", time: "2pm" },
   function(data){
     alert("Data Loaded: " + data);
   });

例子 6

获得 test.php 页面的内容,并存储为 XMLHttpResponse 对象,并通过 process() 这个 JavaScript 函数进行处理:

$.post("test.php", { name: "Bill", time: "2pm" },
   function(data){
     process(data);
   }, "xml");

例子 7

获得 test.php 页面返回的 json 格式的内容:

$.post("test.php", { "func": "getNameAndTime" },
   function(data){
     alert(data.name); // Bill
     console.log(data.time); //  2pm
   }, "json");
点赞