原生 JavaScript 实现 AJAX、JSONP

17,780 阅读5分钟
相信大多数前端开发者在需要与后端进行数据交互时,为了方便快捷,都会选择JQuery中封装的AJAX方法,但是有些时候,我们只需要JQueryAJAX请求方法,而其他的功能用到的很少,这显然是没必要的。
其实,原生JavaScript实现AJAX并不难,这篇文章将会讲解如何实现简单的AJAX,还有跨域请求JSONP
一、AJAX
AJAX的核心是XMLHttpRequest
一个完整的AJAX请求一般包括以下步骤:
  • 实例化XMLHttpRequest对象
  • 连接服务器
  • 发送请求
  • 接收响应数据

我将AJAX请求封装成ajax()方法,它接受一个配置对象params
function ajax(params) { 
 params = params || {}; 
 params.data = params.data || {}; 
 // 判断是ajax请求还是jsonp请求
 var json = params.jsonp ? jsonp(params) : json(params); 
 // ajax请求 
 function json(params) { 
  // 请求方式,默认是GET
  params.type = (params.type || 'GET').toUpperCase();
  // 避免有特殊字符,必须格式化传输数据
  params.data = formatParams(params.data); 
  var xhr = null;  

// 实例化XMLHttpRequest对象 if(window.XMLHttpRequest) { xhr = new XMLHttpRequest(); } else { // IE6及其以下版本 xhr = new ActiveXObjcet('Microsoft.XMLHTTP'); };
// 监听事件,只要 readyState 的值变化,就会调用 readystatechange 事件 xhr.onreadystatechange = function() { // readyState属性表示请求/响应过程的当前活动阶段,4为完成,已经接收到全部响应数据 if(xhr.readyState == 4) { var status = xhr.status; // status:响应的HTTP状态码,以2开头的都是成功 if(status >= 200 && status < 300) { var response = ''; // 判断接受数据的内容类型 var type = xhr.getResponseHeader('Content-type'); if(type.indexOf('xml') !== -1 && xhr.responseXML) { response = xhr.responseXML; //Document对象响应 } else if(type === 'application/json') { response = JSON.parse(xhr.responseText); //JSON响应 } else { response = xhr.responseText; //字符串响应 }; // 成功回调函数 params.success && params.success(response); } else { params.error && params.error(status); } }; }; // 连接和传输数据 if(params.type == 'GET') { // 三个参数:请求方式、请求地址(get方式时,传输数据是加在地址后的)、是否异步请求(同步请求的情况极少); xhr.open(params.type, params.url + '?' + params.data, true); xhr.send(null); } else { xhr.open(params.type, params.url, true); //必须,设置提交时的内容类型 xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded; charset=UTF-8'); // 传输数据 xhr.send(params.data); } } //格式化参数 function formatParams(data) { var arr = []; for(var name in data) { // encodeURIComponent() :用于对 URI 中的某一部分进行编码 arr.push(encodeURIComponent(name) + '=' + encodeURIComponent(data[name])); }; // 添加一个随机数参数,防止缓存 arr.push('v=' + random()); return arr.join('&'); }

// 获取随机数 function random() { return Math.floor(Math.random() * 10000 + 500); }
}
在上面的代码中,已经添加具体的注释,如需了解更多AJAX,可查看博主的书籍《 JavaScript半知半解》中的 AJAX章节:AJAX
使用实例:
ajax({ 
 url: 'test.php',  // 请求地址
 type: 'POST',  // 请求类型,默认"GET",还可以是"POST"
 data: {'b': '异步请求'},  // 传输数据
 success: function(res){  // 请求成功的回调函数
  console.log(JSON.parse(res)); 
 },
 error: function(error) {}  // 请求失败的回调函数
});

二、JSONP
同源策略
AJAX之所以需要“跨域”,罪魁祸首就是浏览器的 同源策略。即,一个页面的AJAX只能获取这个页面相同源或者相同域的数据。 如何叫“同源”或者“同域”呢?——协议、域名、端口号都必须相同。例如:
http://example.com  和  https://example.com 不同,因为协议不同; 
http://localhost:8080  和  http://localhost:1000 不同,因为端口不同; 
http://localhost:8080  和  https://example.com 不同,协议、域名、端口号都不同,根本不是一家的。
当跨域请求时,一般都会看到这个错误: XMLHttpRequest cannot load http://ghmagical.com/article/?intro=jsonp%E8%AF%B7%E6%B1%82&v=5520. No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin 'http://localhost' is therefore not allowed access.

那如何跨域请求呢?这时,JSONP就登场了!
JSONP(JSON with Padding) 是一种跨域请求方式。主要原理是利用了script 标签可以跨域请求的特性,由其 src 属性发送请求到服务器,服务器返回 JavaScript 代码,浏览器接受响应,然后就直接执行了,这和通过 script 标签引用外部文件的原理是一样的。

JSONP由两部分组成:回调函数数据,回调函数一般是在浏览器控制,作为参数发往服务器端(当然,你也可以固定回调函数的名字,但客户端和服务器端的名称一定要一致)。当服务器响应时,服务器端就会把该函数和数据拼成字符串返回。
JSONP的请求过程:
  • 请求阶段:浏览器创建一个 script 标签,并给其src 赋值(类似 http://example.com/api/?callback=jsonpCallback )。
  • 发送请求:当给scriptsrc赋值时,浏览器就会发起一个请求。
  • 数据响应:服务端将要返回的数据作为参数和函数名称拼接在一起(格式类似”jsonpCallback({name: 'abc'})”)返回。当浏览器接收到了响应数据,由于发起请求的是 script,所以相当于直接调用 jsonpCallback 方法,并且传入了一个参数。

对于JQueryJSONP请求,这里就不多讲了,之前也写过一篇文章《JQuery的Ajax请求跨域问题》。
在这里讲解一下用原生JavaScript如何实现。
依旧是ajax()方法里添加JSONP,后面会将两者整合在一起,JSONP的配置参数主要多了一个jsonp参数,它就是你的回调函数名。
function ajax(params) { 
     params = params || {}; 
     params.data = params.data || {}; 
     var json = params.jsonp ? jsonp(params) : json(params);   
    
// jsonp请求 function jsonp(params) { //创建script标签并加入到页面中 var callbackName = params.jsonp; var head = document.getElementsByTagName('head')[0]; // 设置传递给后台的回调参数名 params.data['callback'] = callbackName; var data = formatParams(params.data); var script = document.createElement('script'); head.appendChild(script); //创建jsonp回调函数 window[callbackName] = function(json) { head.removeChild(script); clearTimeout(script.timer); window[callbackName] = null; params.success && params.success(json); };
//发送请求 script.src = params.url + '?' + data;
//为了得知此次请求是否成功,设置超时处理 if(params.time) { script.timer = setTimeout(function() { window[callbackName] = null; head.removeChild(script); params.error && params.error({ message: '超时' }); }, time); } };
//格式化参数 function formatParams(data) { var arr = []; for(var name in data) { arr.push(encodeURIComponent(name) + '=' + encodeURIComponent(data[name])); };
// 添加一个随机数,防止缓存 arr.push('v=' + random()); return arr.join('&'); }
// 获取随机数 function random() { return Math.floor(Math.random() * 10000 + 500); } }
注意:因为 script 标签的 src 属性只在第一次设置的时候起作用,导致 script 标签没法重用,所以每次完成操作之后要移除;
使用实例:
ajax({ 
     url: 'test.php',  // 请求地址
     jsonp: 'jsonpCallback', // 采用jsonp请求,且回调函数名为"jsonpCallbak",可以设置为合法的字符串
     data: {'b': '异步请求'},  // 传输数据
     success:function(res){  // 请求成功的回调函数
      console.log(res); 
     },
     error: function(error) {}  // 请求失败的回调函数
    });
在这里后台使用PHP处理:
<?php
     $data = array('type'=>'jsonp');
     $callback = isset($_GET['callback']) ? trim($_GET['callback']) : ''; 
     echo $callback.'('.json_encode($data).')';
注意:别漏了用函数名与数据拼接返回。
当然,前面也说过,你可以给定固定回调函数名:
function jsonpCallback() {}
    
<?php echo 'jsonpCallback('.$data.

最后我已经将AJAXJSONP请求合并在一起了,下载链接: ajax.zip
如有问题,欢迎在下方留言!