当前位置: 首页>>代码示例 >>用法及示例精选 >>正文

JQuery jQuery.get()用法及代码示例


用法 
jQuery.get( url [, data ] [, success ] [, dataType ] ) => jqXHR

说明：使用 HTTP GET 请求从服务器加载数据。

  • 添加的版本：1.0jQuery.get( url [, data ] [, success ] [, dataType ] )

    • url
      类型：String
      包含请求发送到的 URL 的字符串。
    • data
      类型：PlainObject 或 String
      与请求一起发送到服务器的普通对象或字符串。
    • success
      类型：Function(PlainObject数据，String文本状态，jqXHRjqXHR)
      请求成功时执行的回调函数。如果提供了dataType，则为必需，但您可以使用null 或 jQuery.noop 作为占位符。
    • dataType
      类型：String
      服务器预期的数据类型。默认值：智能猜测(xml、json、脚本、文本、html)。

  • 添加的版本：1.12-and-2.2jQuery.get( [settings ] )

    • settings
      类型：PlainObject
      一组配置 Ajax 请求的键/值对。除url 之外的所有属性都是可选的。可以使用 $.ajaxSetup() 为任何选项设置默认值。有关所有设置的完整列表，请参阅jQuery.ajax( settings )。 type 选项将自动设置为 GET 。

这是一个简写的 Ajax 函数，相当于：

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

success 回调函数传递返回的数据，这将是 XML 根元素、文本字符串、JavaScript 文件或 JSON 对象，具体取决于响应的 MIME 类型。它还传递了响应的文本状态。

从 jQuery 1.5 开始， 这success回调函数也传递了一个"jqXHR" 对象(在jQuery 1.4, 它通过了XMLHttpRequest目的)。但是，由于 JSONP 和 cross-domain GET 请求不使用XHR, 在这些情况下jqXHR和textStatus传递给成功回调的参数未定义。

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

$.get( "ajax/test.html", function( data ) {
  $( ".result" ).html( data );
  alert( "Load was performed." );
});

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

jqXHR 对象

从 jQuery 1.5 开始，所有 jQuery 的 Ajax 方法都返回一个超集XMLHTTPRequest目的。这个 jQuery XHR 对象，或 "jqXHR," 返回$.get()实现 Promise 接口，为其提供 Promise 的所有属性、方法和行为(参见延迟对象了解更多信息)。这jqXHR.done()(为了成功)，jqXHR.fail()(对于错误)，和jqXHR.always()(用于完成，无论是成功还是错误；在 jQuery 1.6 中添加)方法采用一个函数参数，该参数在请求终止时调用。有关此函数接收的参数的信息，请参阅jqXHR 对象的部分$.ajax()文档。

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

// Assign handlers immediately after making the request,
// and remember the jqxhr object for this request
var jqxhr = $.get( "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" 请求都受制于 same origin policy ；请求无法从不同的域、子域、端口或协议成功检索数据。
  • 如果带有 jQuery.get() 的请求返回错误代码，它将静默失败，除非脚本还调用了全局 .ajaxError() 方法。或者，从 jQuery 1.5 开始，jQuery.get() 返回的 jqXHR 对象的 .error() 方法也可用于错误处理。
  • 脚本和 JSONP 请求不受同源策略限制。

例子：

请求test.php 页面，但忽略返回结果。

$.get( "test.php" );

请求test.php 页面并发送一些额外的数据(同时仍然忽略返回结果)。

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

将数据数组传递给服务器(同时仍然忽略返回结果)。

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

警告请求 test.php(HTML 或 XML，取决于返回的内容)的结果。

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

使用额外的数据负载(HTML 或 XML，取决于返回的内容)通过请求 test.cgi 来提醒结果。

$.get( "test.cgi", { name: "John", time: "2pm" } )
  .done(function( data ) {
    alert( "Data Loaded: " + data );
  });

获取test.php页面内容，已经以json格式返回(<?php echo json_encode( array( "name"=>"John","time"=>"2pm" ) ); ?>)，添加到页面中。

$.get( "test.php", function( data ) {
  $( "body" )
    .append( "Name: " + data.name ) // John
    .append( "Time: " + data.time ); //  2pm
}, "json" );

在同一域上获取另一个页面。输出以控制台返回的数据和返回的数据类型。

// If this was sent on https://api.jquery.com/jQuery.get/ you will
// get the response result of https://api.jquery.com/jQuery.ajax/
$.get( "/jQuery.ajax/", function( data ) {
  console.log( typeof data ); // string
  console.log( data ); // HTML content of the jQuery.ajax page
});

相关用法


注：本文由纯净天空筛选整理自jquery.com大神的英文原创作品 jQuery.get()。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。