AbortController.AbortController()
Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
AbortController()
构造函数创建了一个新的 AbortController
实例
Syntax
var controller = new AbortController();
Parameters
无。
Examples
在下面的这段代码中,我们将通过Fetch API来下载一段视频。
首先通过AbortController()
构造函数来创建一个 controller 实例,然后通过AbortController.signal
(en-US) 属性获取到它的关联对象AbortSignal
的引用。
当 fetch request 初始化后,将 AbortSignal
作为一个选项传入请求的选项参数中 (如下 {signal}
). 这将 signal,controller 与 fetch 请求关联起来,允许我们通过调用AbortController.abort()
来取消 fetch 请求,正如下第二个事件监听器所示。
var controller = new AbortController();
var signal = controller.signal;
var downloadBtn = document.querySelector('.download');
var abortBtn = document.querySelector('.abort');
downloadBtn.addEventListener('click', fetchVideo);
abortBtn.addEventListener('click', function() {
controller.abort();
console.log('Download aborted');
});
function fetchVideo() {
...
fetch(url, {signal}).then(function(response) {
...
}).catch(function(e) {
reports.textContent = 'Download error: ' + e.message;
})
}
提示: 当abort()
被调用, fetch()
promise 将会抛出一个AbortError 对象
.
你可以在 GitHub 上找到一个完整的使用示例 — see abort-api (see it running live also).
Specifications
Specification |
---|
DOM Standard # ref-for-dom-abortcontroller-abortcontroller① |
Browser compatibility
BCD tables only load in the browser