JS 中 XMLHttpRequest 原生实现 Ajax 请求步骤

作者:异步漫步

时间:2026-11-22

浏览:312

系统梳理在原生 JavaScript 中使用 XMLHttpRequest 实现 Ajax 请求的标准五个步骤、生命周期状态监听、GET与POST方法实战代码及核心避坑要点。

文章目录
在 JavaScript 中,原生实现 Ajax 请求的核心对象是 XMLHttpRequest。其标准执行流程包含固定的五个步骤:实例化请求对象、调用 open() 初始化请求、调用 setRequestHeader() 设置必要头部、挂载监听回调(如 onload 或 onreadystatechange)以及调用 send() 正式发出网络报文。理解这套底层操作步骤,是掌握浏览器异步通信机制与无刷新局部更新的基石。

一、原生 Ajax 底层机制与运行架构

Ajax(Asynchronous JavaScript and XML)并非单项全新技术,而是一种利用浏览器内置对象与后台服务器进行异步数据交换的开发模式。在现代 Web 应用中,传输载荷虽然绝大部分已采用更紧凑的 JSON 格式,但底层的通信骨架依然由 XMLHttpRequest(简称 XHR)对象支撑。

浏览器采用单线程事件循环驱动 UI 渲染与脚本执行。当发起网络通信时,若直接在 JS 主线程执行同步阻塞调用,会导致整个浏览器页面冻结、无法响应用户的滚动与点击。原生的 XHR 对象通过把耗时的 TCP 连接建立、TLS 握手及数据包收发托付给浏览器底层的网络 I/O 线程,待服务端数据完全回传后,再通过事件队列回调主线程中的处理函数,从而实现真正的异步交互。

JS 中 XMLHttpRequest 原生实现 Ajax 请求步骤
图 1:XMLHttpRequest 原生通信生命周期与三层架构模型示意图

如上图所示,整个交互由三层紧密配合完成:

  • 浏览器主线程:负责实例化 XMLHttpRequest、配置请求参数与回调监听。在发出请求后立刻释放调用栈,不阻塞任何用户界面的交互。
  • XHR 引擎与状态机:负责维持内部的 readyState 状态推演,根据网络报文返回逐步解码响应首部与响应正文,并触发对应的事件钩子。
  • 网络传输与后端 API:通过标准 HTTP/HTTPS 协议承载数据,解析请求并返回状态码与序列化数据包。

二、原生 XMLHttpRequest 请求五大标准步骤

发起一个完整的原生 Ajax 请求,在代码实现层面需严格遵循五个标准步骤。各步骤各司其职,顺序颠倒或遗漏关键配置会导致请求异常甚至抛出运行时错误。

JS 中 XMLHttpRequest 原生实现 Ajax 请求步骤
图 2:原生 XMLHttpRequest 发起 Ajax 请求的标准五大步骤流程图
STEP 01 实例化 XMLHttpRequest 对象

使用 new 关键字在内存中开辟一个 XHR 实例对象。该对象封装了所有与 HTTP 通信相关的属性、方法以及事件处理器。

const xhr = new XMLHttpRequest();

对象创建完成后,其内部就绪状态 xhr.readyState 初始值为 0(UNSENT),表示当前实例已构建完毕但尚未完成初始化。

STEP 02 调用 open() 方法初始化请求

调用 xhr.open() 方法配置请求的基本信息。该方法并不立即发送网络包,其核心职责是在底层建立通信通道并确认请求策略。

xhr.open(method, url, async);

方法接收三个主要参数:

  • method:HTTP 请求动词(如 'GET'、'POST'、'PUT'、'DELETE'),不区分大小写,规范推荐大写。
  • url:目标接口的请求地址,可以是相对路径或绝对路径。
  • async:可选布尔值,指定是否异步执行,默认值为 true。严禁将其显式设为 false(同步模式),否则会挂起浏览器主线程。

执行完 open() 后,xhr.readyState 的状态由 0 变更为 1(OPENED)。

STEP 03 调用 setRequestHeader() 配置请求头部

如果需要在请求中指定身份凭据、告知服务器正文媒体类型或自定义 Header,必须调用 setRequestHeader(header, value)。

xhr.setRequestHeader('Content-Type', 'application/json;charset=UTF-8');
xhr.setRequestHeader('Authorization', 'Bearer token_string');
注意调用时机:setRequestHeader() 必须在 open() 之后、且在 send() 之前调用。如果在 open() 之前调用,对象尚无有效连接配置,浏览器会抛出 InvalidStateError 异常;而在 send() 之后调用,网络报文首部已封包,设置将完全失效。
STEP 04 注册响应事件监听回调

由于网络请求是异步的,必须预先为 XHR 实例绑定监听回调,以便在数据返回时捕获结果。业界有两种常用监听方案:

  • 现代推荐:xhr.onload 与 xhr.onerror
    onload 会在请求彻底完成且数据接收完毕时触发(等价于 readyState 达到 4),代码更为直观简洁;网络层面的物理中断或跨域错误则通过 onerror 捕获。
  • 经典传统:xhr.onreadystatechange
    每当 readyState 属性值发生改变时均会触发一次,因此函数内部必须先校验 xhr.readyState === 4,再校验 HTTP 状态码。
// 现代写法:专注处理完成阶段
xhr.onload = function() {
  if (xhr.status >= 200 && xhr.status < 300) {
    console.log('响应成功:', xhr.responseText);
  } else {
    console.error('HTTP 状态异常:', xhr.status);
  }
};
xhr.onerror = function() {
  console.error('网络层发生严重错误');
};

挂载监听建议统一放置在 send() 之前,以确保在高速本地缓存或极速返回场景下,不会丢失首个触发通知。

STEP 05 调用 send() 方法发送网络请求

调用 xhr.send(body) 正式启动网络通信。该方法负责把请求报文提交到底层网络线程。

// GET 请求无需正文,传入 null 或不传参
xhr.send(null);

// POST 请求传入序列化后的字符串或 FormData 实例
xhr.send(JSON.stringify({ username: 'alice', role: 'admin' }));

三、请求状态监听:readyState 与 HTTP 状态码的双重校验

初学者在实现 Ajax 时常混淆 readyState 与 status 这两个属性。两者的根本区别在于:readyState 衡量的是客户端与通信管道的物理就绪程度,而 status 衡量的是远程 HTTP 服务端的业务响应结果。

readyState 常量 数值 触发时机与具体含义 对应阶段可用属性
UNSENT 0 请求实例刚创建,尚未调用 open() 初始化 无可用响应属性
OPENED 1 open() 方法已被调用,已建立连接参数 可设置请求头与超时配置
HEADERS_RECEIVED 2 send() 已执行,浏览器已接收到响应状态行与所有响应头 可调用 getResponseHeader()
LOADING 3 正文传输中,已接收部分数据体 responseText 包含部分片段
DONE 4 整个数据交互全过程完成,无论是成功还是网络异常 所有数据就绪,必须校验 status
JS 中 XMLHttpRequest 原生实现 Ajax 请求步骤
图 3:XHR 内部 readyState 状态演进与 HTTP 状态码双重判定流程图

从状态图可以看出,当 readyState === 4 时,仅表明“网络包已经下载完毕”,并不代表“后端业务成功”。即便服务器返回 404 Not Found 或 500 Internal Server Error,对客户端网络传输而言依然是顺利完成的,此时 readyState 同样为 4。

正确校验范式:只有当 readyState === 4 且 HTTP 状态码满足 (xhr.status >= 200 && xhr.status < 300) || xhr.status === 304(304 为协商缓存未修改)时,才证明业务数据可安全读取使用。

四、常见场景实战代码:GET 与 POST 原生实现

在日常开发场景中,GET 与 POST 是使用频率最高的两种请求方法。由于 HTTP 规范对两者传输载荷位置的要求不同,在 XHR 代码编写细节上也存在明确差异。

1. 原生 GET 请求完整范例

GET 请求的参数必须直接拼接在 URL 查询字符串中。如果参数中包含中文、空格或 &、= 等保留字符,必须使用 encodeURIComponent() 进行统一转义,防止 URL 被截断解析错误。此外,为了防止某些浏览器对 GET 请求产生激进的静态缓存,可以追加一个时间戳参数。

function ajaxGet(url, params, successCallback, errorCallback) {
  // 1. 实例化
  const xhr = new XMLHttpRequest();

  // 2. 序列化查询参数
  const queryParts = [];
  for (const key in params) {
    if (Object.prototype.hasOwnProperty.call(params, key)) {
      queryParts.push(
        encodeURIComponent(key) + '=' + encodeURIComponent(params[key])
      );
    }
  }
  // 注入时间戳破坏缓存
  queryParts.push('_t=' + Date.now());
  const fullUrl = url + (url.indexOf('?') === -1 ? '?' : '&') + queryParts.join('&');

  // 3. 初始化请求(异步)
  xhr.open('GET', fullUrl, true);

  // 4. 配置响应类型自动解析(可选:json/text/blob)
  xhr.responseType = 'json';

  // 5. 挂载监听事件
  xhr.onload = function() {
    if (xhr.status >= 200 && xhr.status < 300) {
      // responseType 为 'json' 时,xhr.response 已是解析好的 JS 对象
      successCallback(xhr.response);
    } else {
      errorCallback(new Error('请求失败,HTTP 状态码:' + xhr.status));
    }
  };

  xhr.onerror = function() {
    errorCallback(new Error('网络底层连接中断或跨域错误'));
  };

  // 6. 发送请求
  xhr.send(null);
}

2. 原生 POST 请求完整范例(JSON 数据格式)

POST 请求通常用来向服务器提交结构化数据。此时不能把数据裸拼在 URL 中,而是通过 send() 发送请求体。同时,必须通过 setRequestHeader() 显式指定 Content-Type: application/json;charset=UTF-8,服务器才能正确触发 JSON 反序列化解析。

function ajaxPostJson(url, data, successCallback, errorCallback) {
  const xhr = new XMLHttpRequest();

  // 1. 初始化 POST 请求
  xhr.open('POST', url, true);

  // 2. 设置请求头(必须在 open 之后、send 之前)
  xhr.setRequestHeader('Content-Type', 'application/json;charset=UTF-8');

  // 3. 注册完成与失败回调
  xhr.onload = function() {
    if (xhr.status >= 200 && xhr.status < 300) {
      try {
        const res = JSON.parse(xhr.responseText);
        successCallback(res);
      } catch (err) {
        errorCallback(new Error('响应格式并非合法 JSON 文本'));
      }
    } else {
      errorCallback(new Error('HTTP 错误码:' + xhr.status));
    }
  };

  xhr.onerror = function() {
    errorCallback(new Error('网络连通性异常'));
  };

  // 4. 将 JS 对象序列化为字符串后发送
  const payload = JSON.stringify(data);
  xhr.send(payload);
}

五、GET 与 POST 模式对比及技术要素全景

为了在实际开发中准确选型,下表及图示直观对比了两种请求模式在传输行为、编码要求、头部配置与安全边界上的关键差异:

JS 中 XMLHttpRequest 原生实现 Ajax 请求步骤
图 4:原生 Ajax GET 与 POST 请求全要素对比及速查导图

六、高级控制与生产环境避坑指南

在掌握基础实现后,实际业务场景往往还要面临网络波动、跨域策略以及通信超时的考验。以下四个要点在编写原生 Ajax 代码时至关重要:

1. 超时时间配置与中断请求

如果服务端因高负载无响应,默认情况下 XHR 会一直等待连接挂起。原生提供了 xhr.timeout(毫秒单位)以及 xhr.ontimeout 事件来防范网络挂死:

xhr.timeout = 5000; // 限制 5 秒超时
xhr.ontimeout = function() {
  console.warn('请求超时,底层已自动中断通信');
};

// 若用户主动取消(如路由切换离开当前视图),可调用 abort() 手动取消
// xhr.abort();

2. 跨域资源共享(CORS)与携带凭据

受浏览器同源策略限制,当向不同协议、域名或端口发起 Ajax 请求时,目标服务端必须在响应头中包含 Access-Control-Allow-Origin。若跨域请求需要携带 Cookie 或 Session 凭证,前端必须显式声明:

xhr.withCredentials = true;

需要注意,当开启 withCredentials = true 时,服务端返回的 Access-Control-Allow-Origin 绝对不能设置为通配符 *,必须是明确匹配的源站地址。

3. 响应解析:使用 responseType 替代 JSON.parse

传统代码中多在回调里手动调用 JSON.parse(xhr.responseText)。在现代浏览器中,更优雅的方式是在 open() 之后指定 xhr.responseType = 'json'。此时浏览器底层的 C++ 解析引擎会自动处理反序列化,通过 xhr.response 直接读取解析后的 JavaScript 对象,避免在主线程中重复执行字符串解析消耗 CPU。

4. 封装现代 Promise 异步范式

在支持 ES6+ 的项目中,直接嵌套回调函数容易导致回调地狱。我们可以利用上述原生步骤封装一个返回 Promise 的通用函数,与 async/await 语法无缝衔接:

function request({ url, method = 'GET', data = null, headers = {}, timeout = 8000 }) {
  return new Promise((resolve, reject) => {
    const xhr = new XMLHttpRequest();
    xhr.open(method, url, true);
    xhr.timeout = timeout;
    xhr.responseType = 'json';

    // 注入请求头
    for (const h in headers) {
      if (Object.prototype.hasOwnProperty.call(headers, h)) {
        xhr.setRequestHeader(h, headers[h]);
      }
    }

    // 监听完成
    xhr.onload = () => {
      if (xhr.status >= 200 && xhr.status < 300) {
        resolve(xhr.response);
      } else {
        reject(new Error(`HTTP ${xhr.status}: ${xhr.statusText}`));
      }
    };

    // 监听异常
    xhr.onerror = () => reject(new Error('Network Connection Error'));
    xhr.ontimeout = () => reject(new Error('Request Timed Out'));

    // 发送数据
    xhr.send(data);
  });
}

// 使用 async/await 调用示例
async function fetchUserProfile() {
  try {
    const user = await request({
      url: '/api/v1/profile',
      method: 'GET'
    });
    console.log('获取用户信息成功:', user);
  } catch (err) {
    console.error('获取失败:', err.message);
  }
}
结语归纳:原生 XMLHttpRequest 的五步流(new ➔ open ➔ setRequestHeader ➔ onload ➔ send)是整个 Web 前端异步通信的起点。无论上层框架如何演进,理解这套生命周期推演与状态码双重判定机制,都能让开发者在面对复杂的网络联调、数据序列化与错误排查时保持清醒的定位能力。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章