审校 | 梁策 孙淑娟
如果我们想从 API中获取数据或将数据发布到服务器,必须要用到Fetch API。fetch()为我们提供了一种通过请求和响应发送和接收 HTTP 请求的方法,fetch() 函数是一个全局函数,最常用于与 API 交互。
如何在 JavaScript 中使用 Fetch
我们在使用Fetch API获取 URL的数据时,最基本的用法只需要一个参数。当我们运行 Fetch 时,它会有一个返回值:
let fetchExample = fetch("https://fjolt.com").then((res) => {
// Do something with res
});
Res包含一些很有意思的内置函数,如下:
- res.text() :返回 URL 的文本内容。如果是网站,则返回 HTML。
- res.json() :返回格式化的 JSON 数据。
- res.blob() : 返回 blob 数据。
- res.arrayBuffer():返回数组缓冲区数据
- res.formData() :返回 formData 数据。
下面是两个例子:
使用 JavaScript Fetch 获取网站的 HTML 内容
由于res.text()具有可以获取URL 的文本内容的功能,所以可以使用它来获取网站的整个 HTML 。一旦运行 res.text(),我们可以用另一个 then 捕获响应并在控制台记录它:
let websiteData = fetch("https://fjolt.com").then(res => res.text()).then((data) => {
return data;
});
// Now contains our website's HTML.
如果链接不存在或发生错误,响应对象将返回错误。例如,找不到页面将返回 404,或者网关错误将返回 502。
使用 JavaScript Fetch 从链接中获取 JSON 内容
Fetch 的另一个常见用途是获取数组的响应。如果想从 JSON 格式的 API 中获取响应,我们可以使用 res.json()。例如,以下代码将从 URL 返回一个 JSON 对象,假设 URL 正在发送有效的 JSON:
let apiResponse = fetch("https://fjolt.com/api").then(res => res.json()).then((data) => {
return data;
});
// Now contains a JSON object - assuming one exists
JavaScript Fetch 的选项
由于 Fetch 可以发送和接收 HTTP 请求,当我们想要使用它获取 URL数据的时候,还可以带一些选项,即 fetch(URL, { options })。如果你以前使用过 HTTP 请求就会对这很熟悉了。所有可用选项的示例,如下所示:
fetch("https://fjolt.com/", {
body: JSON.stringify({ someData: "value" })
method: 'POST'
mode: 'cors'
cache: 'no-cache'
credentials: 'same-origin'
headers: {
'Content-Type': 'application/json'
},
redirect: 'follow'
referrerPolicy: 'no-referrer'
});
以下是这些选项的具体含义:
- body:包含文本的主体。 在这个例子中,我们发送一些 JSON,它必须被字符串化。
- method:标准的 HTTP 方法。它可以是 POST/GET/DELETE/PUT/CONNECT/PATCH/TRACE/OPTIONS。
- mode:指是否接受跨域请求,它可以是cors/no-cors/same-origin。
- cache:指浏览器如何与Cache交互。 它可以是 default/no-cache/reload/force-cache/only-if-cached。
- Credentials:指是否与请求一起发送跨域 Cookie。它可以是include/same-origin/omit。
- Headers:可以包括与请求关联的任何头部, 例如HTTP 头部这里显示 “Content-Type”,但你也可以拥有自定义 HTTP 头部。
- Redirect:决定了如果Fetch来的URL重定向会发生什么。它可以是follow/error/manual。
- referrerPolicy:确定请求传递的referrer信息量。它可以是 no-referrer/no-referrer-when-downgrade/origin/origin-when-cross-origin/same-origin/strict-origin/strict-origin-when-cross-origin/unsafe-url。
JavaScript:fetch,实现异步请求
当我们使用 Fetch 时,它会转到我们定义的 URL,收集信息并将响应返回。 这不是即时的,因为加载 URL 并将其取回需要时间。如果我们单独运行 Fetch,控制台日志将返回一个 Promise,而不是来自我们想要的 URL 的响应:
let apiResponse = fetch("https://fjolt.com/api");
console.log(apiResponse); // Returns Promise
在fetch() 函数运行时,JavaScript并不会等待响应。如果我们想要访问响应,我们必须明确告诉 JavaScript 需要等待。
等待 fetch() 有两种方法:
- 可以在 then 循环中使用 then 并操作 fetch() 的响应。
- 可以使用 await,并在使用其内容之前等待 Fetch 返回。
在 JavaScript 中使用 Then 等待Fetch
从fetch()调用中访问数据的一种方法是将其链接到Fetch上,从而允许我们从URL访问响应。fetch()的内容可以在then()回调函数内操作,但不能在回调函数外操作。例如:
let apiResponse = fetch("https://fjolt.com/api").then(res => res.json()).then((data) => {
console.log(data);
// We can do anything with the data from our api here.
return data;
});
console.log(apiResponse); // This will return Promise
// That means we can't use the apiResponse variable
// outside of the then() function.
如果我们想在 then 函数之外使用 fetch() 的内容,则必须使用 await。
在 JavaScript 中使用 Await 等待Fetch
等待Fetch的另一种方法是使用 await 关键字。大多数的浏览器都支持Top-level awaits,如果你使用的是Node.JS 14.8 之前的版本,你需要将await相关的代码打包到异步函数中。
如果我们使用 await,可以在函数或代码的任何地方使用它来获取 API 的响应,并在其上使用任何响应函数,例如 text() 或 json()。 例如:
// Typically we wrap await in an async function
// But most modern browsers and Node.JS support
// await statements outside of async functions now.
async getAPI() {
let apiResponse = await fetch("https://fjolt.com/api");
let response = apiResponse.json();
// Since we waited for our API to respond using await
// The response variable will return the response from the API
// And not a promise.
console.log(response);
}
getAPI();
结论
本文中,我们介绍了 Fetch 的工作原理、如何通过 fetch() 发送不同的选项,以及如何使用 JavaScript 中的异步概念来等待响应。 fetch() 是 JavaScript 中的一个强大工具,经常在一些优秀项目中发挥重要作用。
译者介绍
陈豪,51CTO社区编辑,具有6年工作经验的高级系统工程师。擅长技能有Linux内嵌汇编语言,Python,C,C++,Java,Linux内核分析,智能机器人软件设计等。
原文How Fetch Works in JavaScript,作者:Johnny Simpson