本文详细介绍了XMLHTTPRequest项目实战,包括其基本概念、使用方法和一个简单的天气应用示例。通过XMLHTTPRequest项目实战,你将学会如何动态更新网页、发送HTTP请求以及处理服务器响应。示例代码展示了如何从外部API获取数据并在页面上显示,帮助你更好地理解其应用场景和实现步骤。
XMLHTTPRequest简介XMLHTTPRequest 是一个浏览器内置的 JavaScript 对象,它允许我们在不重新加载整个页面的情况下,向服务器发送请求和接收响应。这使得网页能够动态地更新和交互,而无需用户进行刷新操作。XMLHTTPRequest 提供了一种与服务器进行异步通信的方法,大大增强了网页的互动性。
XMLHTTPRequest 对象的主要用途是发送 HTTP 请求并接收响应。其基本的使用方法包括创建对象实例、发送请求、处理响应等步骤。下面是一个基本的使用示例:
var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://example.com/data.json', true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send();
创建一个 XMLHTTPRequest
对象的步骤如下:
XMLHTTPRequest
对象实例。open
方法设置请求类型(如 GET 或 POST),URL 和是否异步。onreadystatechange
监听器,用于监听请求的状态变化。下面是一个创建 XMLHTTPRequest
对象的示例代码:
var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://example.com/data.json', true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send();
在这段代码中,new XMLHttpRequest()
用于创建对象实例,xhr.open('GET', 'https://example.com/data.json', true)
设置了请求类型为 GET,请求的 URL 为 https://example.com/data.json
,并且设置为异步请求。
早期的一些浏览器并没有直接支持 XMLHTTPRequest
,因此需要使用一些兼容性方法来处理不同浏览器的差异。通常的做法是通过条件判断来确定使用哪个类库。
function createXHR() { if (window.XMLHttpRequest) { // 适用于现代浏览器 return new XMLHttpRequest(); } else if (window.ActiveXObject) { // 适用于IE浏览器 return new ActiveXObject("MSXML2.XMLHTTP"); } return null; } var xhr = createXHR();
这段代码定义了一个 createXHR
函数,该函数尝试创建一个 XMLHTTPRequest
对象,并根据不同的浏览器返回不同的实例。如果浏览器支持 XMLHTTPRequest
,则直接使用 new XMLHttpRequest()
。对于不支持 XMLHTTPRequest
的浏览器(如旧版本的 IE),则使用 ActiveXObject
。
属性:
readyState
:表示请求的当前状态,常见的状态值包括 0(未初始化)、1(已初始化)、2(已发送)、3(接收数据)和 4(完成)。status
:表示服务器响应的状态码,如 200(成功)、404(未找到)等。responseText
:包含服务器返回的文本数据。responseXML
:包含服务器返回的 XML 数据。open(method, url, async)
:设置请求方法、请求 URL 和是否异步。send(data)
:发送请求,data
参数可以包含要发送的数据(对于 POST 请求)。abort()
:取消请求。setRequestHeader(header, value)
:设置请求头。发送 GET 请求的基本步骤如下:
open
方法设置请求类型为 GET
,URL 和是否异步。send
方法发送请求。示例代码:
var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://example.com/data.json', true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send();
发送 POST 请求的基本步骤与 GET 请求类似,但需要在 send
方法中传递数据。
示例代码:
var xhr = new XMLHttpRequest(); xhr.open('POST', 'https://example.com/data.json', true); xhr.setRequestHeader('Content-Type', 'application/json'); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send(JSON.stringify({key: 'value'}));
这段代码使用 setRequestHeader
方法设置了请求头,将 Content-Type
设置为 application/json
,并在 send
方法中传递了一个 JSON 字符串。
对于 GET 请求,参数可以通过 URL 的查询字符串来传递。对于 POST 请求,参数可以通过请求体来传递。
示例代码:
// 发送GET请求 var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://example.com/data.json?key=value', true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send(); // 发送POST请求 var xhr = new XMLHttpRequest(); xhr.open('POST', 'https://example.com/data.json', true); xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded'); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send('key=value');
服务器响应可以通过 onreadystatechange
回调函数来处理。当 readyState
改变时,该回调函数会被调用。
示例代码:
var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://example.com/data.json', true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send();
可以通过检查 status
属性来判断请求是否成功。例如,200 表示请求成功,404 表示未找到。
示例代码:
var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://example.com/data.json', true); xhr.onreadystatechange = function() { if (xhr.readyState === 4) { if (xhr.status === 200) { console.log('请求成功'); console.log(xhr.responseText); } else if (xhr.status === 404) { console.log('未找到'); } } }; xhr.send();
服务器返回的数据通常是以文本或 JSON 格式提供的。可以通过 responseText
或 responseXML
来获取数据。
示例代码:
var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://example.com/data.json', true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { var data = JSON.parse(xhr.responseText); console.log(data); } }; xhr.send();
这段代码将服务器返回的 JSON 字符串解析为 JavaScript 对象。
优点:
虽然异步请求更为常见,但在某些情况下仍需要使用同步请求:
优点:
异步请求是通过设置 open
方法的第三个参数为 true
来实现的。这样在发送请求的同时,页面可以继续执行其他操作。
示例代码:
var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://example.com/data.json', true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { console.log(xhr.responseText); } }; xhr.send();
项目目标是构建一个简单的网页应用,该应用能够从服务器获取数据并在页面上显示。具体需求如下:
HTML 结构
<div id="app"> <input type="text" id="city" placeholder="输入城市名"> <button id="fetch">获取天气</button> <div id="weather"></div> </div>
CSS 样式
#app { width: 300px; margin: 0 auto; padding: 20px; border: 1px solid #ccc; border-radius: 5px; }
JavaScript 代码
document.getElementById('fetch').addEventListener('click', function() { var city = document.getElementById('city').value; var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://api.weather.com/weather.json?city=' + city, true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { var weatherData = JSON.parse(xhr.responseText); document.getElementById('weather').innerHTML = ` <p>城市: ${weatherData.city}</p> <p>温度: ${weatherData.temp}°C</p> <p>天气: ${weatherData.weather}</p> `; } else if (xhr.readyState === 4 && xhr.status !== 200) { document.getElementById('weather').innerHTML = '获取天气信息失败'; } }; xhr.send(); });
调试
优化
示例代码:
document.getElementById('fetch').addEventListener('click', function() { var city = document.getElementById('city').value; var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://api.weather.com/weather.json?city=' + city, true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { var weatherData = JSON.parse(xhr.responseText); document.getElementById('weather').innerHTML = ` <p>城市: ${weatherData.city}</p> <p>温度: ${weatherData.temp}°C</p> <p>天气: ${weatherData.weather}</p> `; } else if (xhr.readyState === 4 && xhr.status !== 200) { document.getElementById('weather').innerHTML = '获取天气信息失败'; } }; xhr.send(); });
这段代码中,当请求成功时,会将天气信息显示在页面上。如果请求失败,则显示失败提示。
为了进一步优化用户体验,可以在发送请求时添加一个加载提示:
document.getElementById('fetch').addEventListener('click', function() { var city = document.getElementById('city').value; document.getElementById('weather').innerHTML = '加载中...'; var xhr = new XMLHttpRequest(); xhr.open('GET', 'https://api.weather.com/weather.json?city=' + city, true); xhr.onreadystatechange = function() { if (xhr.readyState === 4 && xhr.status === 200) { var weatherData = JSON.parse(xhr.responseText); document.getElementById('weather').innerHTML = ` <p>城市: ${weatherData.city}</p> <p>温度: ${weatherData.temp}°C</p> <p>天气: ${weatherData.weather}</p> `; } else if (xhr.readyState === 4 && xhr.status !== 200) { document.getElementById('weather').innerHTML = '获取天气信息失败'; } }; xhr.send(); });
通过以上步骤,我们已经构建了一个简单的天气应用,展示了如何使用 XMLHTTPRequest 进行数据交互。