XMLHttpRequest 是浏览器原生 AJAX 实现,需调用 .open() 初始化、.send() 发送,通过监听 onload/onerror/ontimeout 处理响应与错误,且须等待 readyState === 4 才能读取响应。

AJAX 不是某个函数或库,而是用 JavaScript 在不刷新页面的前提下和服务器交换数据的一类技术方案;XMLHttpRequest 是浏览器原生提供的、最基础的实现方式。
XMLHttpRequest 的基本用法长什么样?
它需要手动创建实例、配置请求、监听响应、处理错误——不是一行就能发出去的“快捷函数”。现代项目多用 fetch,但理解 XMLHttpRequest 有助于排查老代码或特殊场景(比如上传进度监听)。
- 必须调用
.open()设置请求方法、URL 和是否异步,否则.send()会报错 -
.send()后不能立刻读取.responseText,要等readyState === 4且status === 200 - 推荐始终监听
onerror和ontimeout,仅靠onload无法捕获网络中断或 CORS 拒绝
const xhr = new XMLHttpRequest();
xhr.open('GET', '/api/user?id=123');
xhr.timeout = 5000;
xhr.onload = function() {
if (xhr.status >= 200 && xhr.status < 300) {
console.log(JSON.parse(xhr.responseText));
} else {
console.error('HTTP error:', xhr.status);
}
};
xhr.onerror = function() {
console.error('Network error');
};
xhr.ontimeout = function() {
console.error('Request timeout');
};
xhr.send();
POST 请求要额外注意什么?
和 GET 不同,POST 需要设置请求头、序列化数据,并确保后端能正确解析。漏掉 Content-Type 或传错格式,后端很可能收不到 req.body。
- 发送 JSON:设
Content-Type: application/json,用JSON.stringify()转字符串 - 发送表单数据:设
Content-Type: application/x-www-form-urlencoded,用URLSearchParams或手动拼接key=value&key2=value2 - 不要对
FormData对象再设Content-Type,浏览器会自动加带 boundary 的 multipart 头
const xhr = new XMLHttpRequest();
xhr.open('POST', '/api/login');
// 发送 JSON
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.send(JSON.stringify({ username: 'admin', password: '123' }));
// 或发送表单数据
// xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
// xhr.send(new URLSearchParams({ username: 'admin', password: '123' }));
为什么有时 readyState 一直是 0 或 2?
常见于跨域、协议不匹配(如 HTTP 页面请求 HTTPS 接口)、URL 写错、或服务根本没启动。此时 xhr.status 为 0,xhr.statusText 为空字符串——这不是业务错误,而是网络层失败,onload 根本不会触发。
立即学习“Java免费学习笔记(深入)”;
- 检查浏览器控制台 Network 面板里该请求是否出现,状态码是不是
(blocked:cors)或(failed) - 确认 URL 协议(
http://vshttps://)、域名、端口是否与当前页面一致,或后端已配好 CORS 响应头 - 本地开发时如果用
file://打开 HTML,XMLHttpRequest会直接被浏览器拒绝,必须起一个本地服务(如npx http-server)
真正难调试的不是语法,而是状态机跳转时机和网络环境的耦合——比如在 onreadystatechange 里没判断 readyState === 4 就去读响应,或者把超时时间设得太短导致弱网下必失败。











