aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/window/cancelidlecallback/index.html
blob: 79abf32d9351f5dcc1d254cb0d2da09b17dd448a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
---
title: window.cancelIdleCallback()
slug: Web/API/Window/cancelIdleCallback
tags:
  - API
  - JavaScript timers
  - Window
  - cancelIdleCallback
translation_of: Web/API/Window/cancelIdleCallback
---
<div>{{APIRef}}{{SeeCompatTable}}</div>

<h2 id="Summary" name="Summary">概述</h2>

<p> <strong><code>window.cancelIdleCallback()</code></strong> 方法用于取消之前调用{{domxref("window.requestIdleCallback()")}} 的回调。</p>

<h2 id="Syntax" name="Syntax">语法</h2>

<pre class="syntaxbox">window.cancelIdleCallback(<em>handle</em>);</pre>

<h3 id="Parameters" name="Parameters">参数</h3>

<dl>
 <dt><code>handle</code></dt>
 <dd>调用 {{domxref("window.requestIdleCallback()")}}  时返回的 ID.</dd>
</dl>

<h3 id="返回值">返回值</h3>

<p><code>undefined</code>.</p>

<h2 id="示例">示例</h2>

<p>在文章 <a href="/en-US/docs/Web/API/Background_Tasks_API">Cooperative Scheduling of Background Tasks API</a> 中可以查看<a href="/en-US/docs/Web/API/Background_Tasks_API#Example"> 完整示例</a> 。</p>

<h2 id="Specifications" name="Specifications">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th>Specification</th>
   <th>Status</th>
   <th>Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Background Tasks')}}</td>
   <td>{{Spec2('Background Tasks')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatChrome(47)}}</td>
   <td>{{CompatGeckoDesktop(53)}}<sup>[1]</sup></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android Webview</th>
   <th>Chrome for Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatChrome(47)}}</td>
   <td>{{CompatChrome(47)}}</td>
   <td>{{CompatGeckoMobile(53)}}<sup>[1]</sup></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Idle callback 在  Firefox 53 中增加, 默认是禁用状态,设置  <code>dom.requestIdleCallback.enabled</code> 为 <code>true</code>启用。 Idle callbacks 再 Firefox 55及之后版本中默认启用。</p>