1# 定时器<a name="ZH-CN_TOPIC_0000001164290732"></a> 2 3## 导入模块<a name="zh-cn_topic_0000001173324687_section7480141454919"></a> 4 5无需导入。 6 7## 权限列表<a name="zh-cn_topic_0000001173324687_section11257113618419"></a> 8 9无 10 11## setTimeout<a name="zh-cn_topic_0000001173324687_section691616559215"></a> 12 13setTimeout\(handler\[,delay\[,…args\]\]\): number 14 15设置一个定时器，该定时器在定时器到期后执行一个函数。 16 17- 参数 18 19 <a name="zh-cn_topic_0000001173324687_t80f094cffa594e7e842eccce3bf1eb19"></a> 20 <table><thead align="left"><tr id="zh-cn_topic_0000001173324687_rd6c76d49b85e4aea9496fd457b189a2a"><th class="cellrowborder" valign="top" width="14.180000000000001%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001173324687_aca3ed031fef246189779018bbcab4df3"><a name="zh-cn_topic_0000001173324687_aca3ed031fef246189779018bbcab4df3"></a><a name="zh-cn_topic_0000001173324687_aca3ed031fef246189779018bbcab4df3"></a>参数名</p> 21 </th> 22 <th class="cellrowborder" valign="top" width="16.61%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001173324687_a89f9e11cc75c4aa9b0b31af966020f61"><a name="zh-cn_topic_0000001173324687_a89f9e11cc75c4aa9b0b31af966020f61"></a><a name="zh-cn_topic_0000001173324687_a89f9e11cc75c4aa9b0b31af966020f61"></a>类型</p> 23 </th> 24 <th class="cellrowborder" valign="top" width="6.3%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001173324687_a411664c3845840d4b2a6845105703f3b"><a name="zh-cn_topic_0000001173324687_a411664c3845840d4b2a6845105703f3b"></a><a name="zh-cn_topic_0000001173324687_a411664c3845840d4b2a6845105703f3b"></a>必填</p> 25 </th> 26 <th class="cellrowborder" valign="top" width="62.91%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001173324687_ac962681702ac49e09c77a1270af9ecb2"><a name="zh-cn_topic_0000001173324687_ac962681702ac49e09c77a1270af9ecb2"></a><a name="zh-cn_topic_0000001173324687_ac962681702ac49e09c77a1270af9ecb2"></a>说明</p> 27 </th> 28 </tr> 29 </thead> 30 <tbody><tr id="zh-cn_topic_0000001173324687_r9d3ffb29e7e74ff4b18e0a3e3ad04925"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001173324687_p1411112320620"><a name="zh-cn_topic_0000001173324687_p1411112320620"></a><a name="zh-cn_topic_0000001173324687_p1411112320620"></a>handler</p> 31 </td> 32 <td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001173324687_p11016237618"><a name="zh-cn_topic_0000001173324687_p11016237618"></a><a name="zh-cn_topic_0000001173324687_p11016237618"></a>Function</p> 33 </td> 34 <td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001173324687_p1892231068"><a name="zh-cn_topic_0000001173324687_p1892231068"></a><a name="zh-cn_topic_0000001173324687_p1892231068"></a>是</p> 35 </td> 36 <td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001173324687_p788516491307"><a name="zh-cn_topic_0000001173324687_p788516491307"></a><a name="zh-cn_topic_0000001173324687_p788516491307"></a>定时器到期后执行函数。</p> 37 </td> 38 </tr> 39 <tr id="zh-cn_topic_0000001173324687_r57344f1bd4304d548bf54ba81dbe8fa5"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001173324687_p13718237614"><a name="zh-cn_topic_0000001173324687_p13718237614"></a><a name="zh-cn_topic_0000001173324687_p13718237614"></a>delay</p> 40 </td> 41 <td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001173324687_p261239618"><a name="zh-cn_topic_0000001173324687_p261239618"></a><a name="zh-cn_topic_0000001173324687_p261239618"></a>number</p> 42 </td> 43 <td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001173324687_p17516231062"><a name="zh-cn_topic_0000001173324687_p17516231062"></a><a name="zh-cn_topic_0000001173324687_p17516231062"></a>否</p> 44 </td> 45 <td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001173324687_p1943234615"><a name="zh-cn_topic_0000001173324687_p1943234615"></a><a name="zh-cn_topic_0000001173324687_p1943234615"></a>延迟的毫秒数，函数的调用会在该延迟之后发生。如果省略该参数，delay取默认值0，意味着“马上”执行，或尽快执行。</p> 46 </td> 47 </tr> 48 <tr id="zh-cn_topic_0000001173324687_r41a55619ed484b7092dfc843ebd4fba1"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001173324687_p103182316615"><a name="zh-cn_topic_0000001173324687_p103182316615"></a><a name="zh-cn_topic_0000001173324687_p103182316615"></a>...args</p> 49 </td> 50 <td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001173324687_p1321231162"><a name="zh-cn_topic_0000001173324687_p1321231162"></a><a name="zh-cn_topic_0000001173324687_p1321231162"></a>Array<any></p> 51 </td> 52 <td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001173324687_p11111231363"><a name="zh-cn_topic_0000001173324687_p11111231363"></a><a name="zh-cn_topic_0000001173324687_p11111231363"></a>否</p> 53 </td> 54 <td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001173324687_p139991022863"><a name="zh-cn_topic_0000001173324687_p139991022863"></a><a name="zh-cn_topic_0000001173324687_p139991022863"></a>附加参数，一旦定时器到期，它们会作为参数传递给handler。</p> 55 </td> 56 </tr> 57 </tbody> 58 </table> 59 60- 返回值 61 62 <a name="zh-cn_topic_0000001173324687_table1430416594311"></a> 63 <table><thead align="left"><tr id="zh-cn_topic_0000001173324687_row230485973113"><th class="cellrowborder" valign="top" width="12.18%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001173324687_p430405913312"><a name="zh-cn_topic_0000001173324687_p430405913312"></a><a name="zh-cn_topic_0000001173324687_p430405913312"></a>类型</p> 64 </th> 65 <th class="cellrowborder" valign="top" width="87.82%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001173324687_p830413599312"><a name="zh-cn_topic_0000001173324687_p830413599312"></a><a name="zh-cn_topic_0000001173324687_p830413599312"></a>说明</p> 66 </th> 67 </tr> 68 </thead> 69 <tbody><tr id="zh-cn_topic_0000001173324687_row130435914317"><td class="cellrowborder" valign="top" width="12.18%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001173324687_p4305759143119"><a name="zh-cn_topic_0000001173324687_p4305759143119"></a><a name="zh-cn_topic_0000001173324687_p4305759143119"></a>number</p> 70 </td> 71 <td class="cellrowborder" valign="top" width="87.82%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001173324687_p130555923110"><a name="zh-cn_topic_0000001173324687_p130555923110"></a><a name="zh-cn_topic_0000001173324687_p130555923110"></a>timeout定时器的ID。</p> 72 </td> 73 </tr> 74 </tbody> 75 </table> 76 77- 示例 78 79 ``` 80 var timeoutID = setTimeout(function() { 81 console.log('delay 1s'); 82 }, 1000); 83 ``` 84 85 86## clearTimeout<a name="zh-cn_topic_0000001173324687_section591824471012"></a> 87 88clearTimeout\(timeoutID: number\): void 89 90取消了先前通过调用setTimeout\(\)建立的定时器。 91 92- 参数 93 94 <a name="zh-cn_topic_0000001173324687_table242593951313"></a> 95 <table><thead align="left"><tr id="zh-cn_topic_0000001173324687_row1642533921320"><th class="cellrowborder" valign="top" width="14.180000000000001%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001173324687_p15425539131316"><a name="zh-cn_topic_0000001173324687_p15425539131316"></a><a name="zh-cn_topic_0000001173324687_p15425539131316"></a>参数名</p> 96 </th> 97 <th class="cellrowborder" valign="top" width="9.700000000000001%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001173324687_p442518395136"><a name="zh-cn_topic_0000001173324687_p442518395136"></a><a name="zh-cn_topic_0000001173324687_p442518395136"></a>类型</p> 98 </th> 99 <th class="cellrowborder" valign="top" width="6.18%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001173324687_p6425153915136"><a name="zh-cn_topic_0000001173324687_p6425153915136"></a><a name="zh-cn_topic_0000001173324687_p6425153915136"></a>必填</p> 100 </th> 101 <th class="cellrowborder" valign="top" width="69.94%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001173324687_p9425193910134"><a name="zh-cn_topic_0000001173324687_p9425193910134"></a><a name="zh-cn_topic_0000001173324687_p9425193910134"></a>说明</p> 102 </th> 103 </tr> 104 </thead> 105 <tbody><tr id="zh-cn_topic_0000001173324687_row1442613913132"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001173324687_p16426133931310"><a name="zh-cn_topic_0000001173324687_p16426133931310"></a><a name="zh-cn_topic_0000001173324687_p16426133931310"></a>timeoutID</p> 106 </td> 107 <td class="cellrowborder" valign="top" width="9.700000000000001%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001173324687_p16426639151316"><a name="zh-cn_topic_0000001173324687_p16426639151316"></a><a name="zh-cn_topic_0000001173324687_p16426639151316"></a>number</p> 108 </td> 109 <td class="cellrowborder" valign="top" width="6.18%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001173324687_p1426739141312"><a name="zh-cn_topic_0000001173324687_p1426739141312"></a><a name="zh-cn_topic_0000001173324687_p1426739141312"></a>是</p> 110 </td> 111 <td class="cellrowborder" valign="top" width="69.94%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001173324687_p6426183941319"><a name="zh-cn_topic_0000001173324687_p6426183941319"></a><a name="zh-cn_topic_0000001173324687_p6426183941319"></a>要取消定时器的ID， 是由setTimeout()返回的。</p> 112 </td> 113 </tr> 114 </tbody> 115 </table> 116 117- 示例 118 119 ``` 120 var timeoutID = setTimeout(function() { 121 console.log('do after 1s delay.'); 122 }, 1000); 123 124 clearTimeout(timeoutID); 125 ``` 126 127 128## setInterval<a name="zh-cn_topic_0000001173324687_section3644185910144"></a> 129 130setInterval\(handler\[, delay\[, ...args\]\]\): number 131 132重复调用一个函数，在每次调用之间具有固定的时间延迟。 133 134- 参数 135 136 <a name="zh-cn_topic_0000001173324687_table2064413592143"></a> 137 <table><thead align="left"><tr id="zh-cn_topic_0000001173324687_row16441591142"><th class="cellrowborder" valign="top" width="14.180000000000001%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001173324687_p0644195915145"><a name="zh-cn_topic_0000001173324687_p0644195915145"></a><a name="zh-cn_topic_0000001173324687_p0644195915145"></a>参数名</p> 138 </th> 139 <th class="cellrowborder" valign="top" width="16.61%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001173324687_p1264413594142"><a name="zh-cn_topic_0000001173324687_p1264413594142"></a><a name="zh-cn_topic_0000001173324687_p1264413594142"></a>类型</p> 140 </th> 141 <th class="cellrowborder" valign="top" width="6.3%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001173324687_p86449591147"><a name="zh-cn_topic_0000001173324687_p86449591147"></a><a name="zh-cn_topic_0000001173324687_p86449591147"></a>必填</p> 142 </th> 143 <th class="cellrowborder" valign="top" width="62.91%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001173324687_p16644185991417"><a name="zh-cn_topic_0000001173324687_p16644185991417"></a><a name="zh-cn_topic_0000001173324687_p16644185991417"></a>说明</p> 144 </th> 145 </tr> 146 </thead> 147 <tbody><tr id="zh-cn_topic_0000001173324687_row264495931412"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001173324687_p8644659161413"><a name="zh-cn_topic_0000001173324687_p8644659161413"></a><a name="zh-cn_topic_0000001173324687_p8644659161413"></a>handler</p> 148 </td> 149 <td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001173324687_p7645259181410"><a name="zh-cn_topic_0000001173324687_p7645259181410"></a><a name="zh-cn_topic_0000001173324687_p7645259181410"></a>Function</p> 150 </td> 151 <td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001173324687_p12645259111415"><a name="zh-cn_topic_0000001173324687_p12645259111415"></a><a name="zh-cn_topic_0000001173324687_p12645259111415"></a>是</p> 152 </td> 153 <td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001173324687_p4645155931418"><a name="zh-cn_topic_0000001173324687_p4645155931418"></a><a name="zh-cn_topic_0000001173324687_p4645155931418"></a>要重复调用的函数。</p> 154 </td> 155 </tr> 156 <tr id="zh-cn_topic_0000001173324687_row264575911146"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001173324687_p17645159201410"><a name="zh-cn_topic_0000001173324687_p17645159201410"></a><a name="zh-cn_topic_0000001173324687_p17645159201410"></a>delay</p> 157 </td> 158 <td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001173324687_p3645175951416"><a name="zh-cn_topic_0000001173324687_p3645175951416"></a><a name="zh-cn_topic_0000001173324687_p3645175951416"></a>number</p> 159 </td> 160 <td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001173324687_p1645185981412"><a name="zh-cn_topic_0000001173324687_p1645185981412"></a><a name="zh-cn_topic_0000001173324687_p1645185981412"></a>否</p> 161 </td> 162 <td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001173324687_p13645559141415"><a name="zh-cn_topic_0000001173324687_p13645559141415"></a><a name="zh-cn_topic_0000001173324687_p13645559141415"></a>延迟的毫秒数（一秒等于1000毫秒），函数的调用会在该延迟之后发生。</p> 163 </td> 164 </tr> 165 <tr id="zh-cn_topic_0000001173324687_row96452594148"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001173324687_p4645105911412"><a name="zh-cn_topic_0000001173324687_p4645105911412"></a><a name="zh-cn_topic_0000001173324687_p4645105911412"></a>...args</p> 166 </td> 167 <td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001173324687_p1564595951413"><a name="zh-cn_topic_0000001173324687_p1564595951413"></a><a name="zh-cn_topic_0000001173324687_p1564595951413"></a>Array<any></p> 168 </td> 169 <td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001173324687_p12645175971411"><a name="zh-cn_topic_0000001173324687_p12645175971411"></a><a name="zh-cn_topic_0000001173324687_p12645175971411"></a>否</p> 170 </td> 171 <td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001173324687_p12645105991413"><a name="zh-cn_topic_0000001173324687_p12645105991413"></a><a name="zh-cn_topic_0000001173324687_p12645105991413"></a>附加参数，一旦定时器到期，他们会作为参数传递给handler。</p> 172 </td> 173 </tr> 174 </tbody> 175 </table> 176 177- 返回值 178 179 <a name="zh-cn_topic_0000001173324687_table1947971515356"></a> 180 <table><thead align="left"><tr id="zh-cn_topic_0000001173324687_row247915156359"><th class="cellrowborder" valign="top" width="12.18%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001173324687_p54794159353"><a name="zh-cn_topic_0000001173324687_p54794159353"></a><a name="zh-cn_topic_0000001173324687_p54794159353"></a>类型</p> 181 </th> 182 <th class="cellrowborder" valign="top" width="87.82%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001173324687_p14798156359"><a name="zh-cn_topic_0000001173324687_p14798156359"></a><a name="zh-cn_topic_0000001173324687_p14798156359"></a>说明</p> 183 </th> 184 </tr> 185 </thead> 186 <tbody><tr id="zh-cn_topic_0000001173324687_row747919155356"><td class="cellrowborder" valign="top" width="12.18%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001173324687_p6479101518359"><a name="zh-cn_topic_0000001173324687_p6479101518359"></a><a name="zh-cn_topic_0000001173324687_p6479101518359"></a>number</p> 187 </td> 188 <td class="cellrowborder" valign="top" width="87.82%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001173324687_p10479151518353"><a name="zh-cn_topic_0000001173324687_p10479151518353"></a><a name="zh-cn_topic_0000001173324687_p10479151518353"></a>intervallID重复定时器的ID。</p> 189 </td> 190 </tr> 191 </tbody> 192 </table> 193 194- 示例 195 196 ``` 197 var intervalID = setInterval(function() { 198 console.log('do very 1s.'); 199 }, 1000); 200 ``` 201 202 203## clearInterval<a name="zh-cn_topic_0000001173324687_section16451595149"></a> 204 205clearInterval\(intervalID: number\): void 206 207可取消先前通过 setInterval\(\) 设置的重复定时任务。 208 209- 参数 210 211 <a name="zh-cn_topic_0000001173324687_table86463597147"></a> 212 <table><thead align="left"><tr id="zh-cn_topic_0000001173324687_row146462597148"><th class="cellrowborder" valign="top" width="14.180000000000001%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001173324687_p176461759111416"><a name="zh-cn_topic_0000001173324687_p176461759111416"></a><a name="zh-cn_topic_0000001173324687_p176461759111416"></a>参数名</p> 213 </th> 214 <th class="cellrowborder" valign="top" width="9.700000000000001%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001173324687_p8646195918141"><a name="zh-cn_topic_0000001173324687_p8646195918141"></a><a name="zh-cn_topic_0000001173324687_p8646195918141"></a>类型</p> 215 </th> 216 <th class="cellrowborder" valign="top" width="6.18%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001173324687_p19646165981415"><a name="zh-cn_topic_0000001173324687_p19646165981415"></a><a name="zh-cn_topic_0000001173324687_p19646165981415"></a>必填</p> 217 </th> 218 <th class="cellrowborder" valign="top" width="69.94%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001173324687_p8646185961419"><a name="zh-cn_topic_0000001173324687_p8646185961419"></a><a name="zh-cn_topic_0000001173324687_p8646185961419"></a>说明</p> 219 </th> 220 </tr> 221 </thead> 222 <tbody><tr id="zh-cn_topic_0000001173324687_row12646125914143"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001173324687_p1964675951413"><a name="zh-cn_topic_0000001173324687_p1964675951413"></a><a name="zh-cn_topic_0000001173324687_p1964675951413"></a>intervalID</p> 223 </td> 224 <td class="cellrowborder" valign="top" width="9.700000000000001%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001173324687_p1864625921419"><a name="zh-cn_topic_0000001173324687_p1864625921419"></a><a name="zh-cn_topic_0000001173324687_p1864625921419"></a>number</p> 225 </td> 226 <td class="cellrowborder" valign="top" width="6.18%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001173324687_p3646145921419"><a name="zh-cn_topic_0000001173324687_p3646145921419"></a><a name="zh-cn_topic_0000001173324687_p3646145921419"></a>是</p> 227 </td> 228 <td class="cellrowborder" valign="top" width="69.94%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001173324687_p7646459141416"><a name="zh-cn_topic_0000001173324687_p7646459141416"></a><a name="zh-cn_topic_0000001173324687_p7646459141416"></a>要取消的重复定时器的ID，是由 setInterval() 返回的。</p> 229 </td> 230 </tr> 231 </tbody> 232 </table> 233 234- 示例 235 236 ``` 237 var intervalID = setInterval(function() { 238 console.log('do very 1s.'); 239 }, 1000); 240 241 clearInterval(intervalID); 242 ``` 243 244 245