此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Window:setInterval() 方法

基线 广泛可用 *

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

* 此特性的某些部分的支持程度可能有所不同。

Window 接口的 setInterval() 方法重复调用一个函数或执行一个代码片段,在每次调用之间具有固定的时间间隔。

此方法返回一个间隔 ID,其唯一地标识时间间隔,因此你可以稍后通过调用 clearInterval() 来移除它。

语法

js
setInterval(code)
setInterval(code, delay)

setInterval(func)
setInterval(func, delay)
setInterval(func, delay, arg1)
setInterval(func, delay, arg1, arg2)
setInterval(func, delay, arg1, arg2, /* …, */ argN)

参数

func

要每隔 delay 毫秒执行一次的函数。第一次执行发生在 delay 毫秒之后。

code

这个可选的语法让你可以传递一个字符串来代替函数,你传递的字符串会被编译然后每经过 delay 毫秒执行一次。这个语法因为与 eval() 存在相同的安全风险所以不推荐使用。

delay 可选

计时器每次执行指定的函数和代码的延迟时间(以毫秒——千分之一秒——为单位)。如果未指定,则其默认值为 0。参见下方的延迟限制以了解详细的 delay 的取值范围。

arg1、……、argN 可选

当计时器结束的时候,将被传递给 func 函数的附加参数。

返回值

返回值 intervalID 是一个非零数值,用来标识调用 setInterval() 创建的定时器;这个值可以用来传递给 clearInterval() 来清除定时器。

值得注意的是,setInterval()setTimeout() 共享同一个 ID 池,并且 clearInterval()clearTimeout() 在技术上是可互换使用的。然而,为了清晰可见,你应该尝试始终匹配,以避免维护代码时产生混淆。

备注:参数 delay 会被转换成一个有符号 32 位整数。这将 delay 限制到了 2147483647 毫秒(大约 24.8 天)以内,因为它在 IDL 中被指定为一个有符号整数。

示例

例 1:基本语法

下面例子演示了 setInterval() 的基本语法。

js
var intervalID = setInterval(myCallback, 500, "参数 1", "参数 2");

function myCallback(a, b) {
  // 在这里编写你的代码
  // 参数完全是可选的。
  console.log(a);
  console.log(b);
}

例 2:两种颜色的切换

下面的例子会每隔一秒就调用一次 flashtext() 函数,直至你按下停止按钮。

HTML

html
<div id="my_box">
  <h3>你好世界</h3>
</div>
<button id="start">开始</button>
<button id="stop">停止</button>

CSS

css
.go {
  color: green;
}
.stop {
  color: red;
}

JavaScript

js
// 用于存储 intervalID 的变量
let nIntervId;

function changeColor() {
  // 检查是否已经设置了定时器
  if (!nIntervId) {
    nIntervId = setInterval(flashText, 1000);
  }
}

function flashText() {
  const oElem = document.getElementById("my_box");
  oElem.className = oElem.className === "go" ? "stop" : "go";
}

function stopTextColor() {
  clearInterval(nIntervId);
  // 释放 intervalID
  nIntervId = null;
}

document.getElementById("start").addEventListener("click", changeColor);
document.getElementById("stop").addEventListener("click", stopTextColor);

结果

“this”的问题

当你将一个方法传递给 setInterval() 或其他函数时,它在被调用时会绑定错误的 this 值。这个问题在 JavaScript 参考进行了详细解释。

解释

setInterval() 调用的代码在与调用它的函数不同的上下文中运行。因此,被调用函数的 this 关键字被设置为了 windows(或 global)对象,而不是调用 setTimeout 时的 this。请看以下的示例(它使用 setTimeout() 代替了 setInterval()——但两种定时器都具有这一的问题):

js
const myArray = ["零", "一", "二"];

myArray.myMethod = function (sProperty) {
  alert(arguments.length > 0 ? this[sProperty] : this);
};

myArray.myMethod(); // 打印“零,一,二”
myArray.myMethod(1); // 打印“一”
setTimeout(myArray.myMethod, 1000); // 在 1 秒后打印“[object Window]”
setTimeout(myArray.myMethod, 1500, "1"); // 在 1.5 秒后打印“undefined”

// 使用 .call 传递“this”对象不起作用
// 因为这会改变 setTimeout 自身内部的 this 值
// 而我们想要改变的是 myArray.myMethod 内部的 this 值
// 实际上,这会导致错误,因为 setTimeout 代码期望 this 是 window 对象:
setTimeout.call(myArray, myArray.myMethod, 2000); // 错误:“NS_ERROR_XPC_BAD_OP_ON_WN_PROTO: Illegal operation on WrappedNative prototype object”
setTimeout.call(myArray, myArray.myMethod, 2500, 2); // 相同的错误

如你所见,在旧版 JavaScript 中无法将 this 对象传递给回调函数。

一个可能的解决方案

所有现代 JavaScript 运行时(浏览器或其他地方)都支持箭头函数(携带词法 this)——允许我们在 myArray 方法内,编写 setInterval(() => this.myMethod())

如果你需要支持 IE 浏览器,请使用 Function.prototype.bind() 方法,它允许你指定调用给定函数时 this 的值。这可以让你避免因为上下文的不同而导致调用的函数的 this 不明确而出现的问题。

使用说明

setInterval() 函数通常用于为重复执行的函数设置一个时间间隔(例如:动画)。你可以使用 clearInterval() 取消定时器。

如果你希望在指定的延迟后,仅执行一次函数,请使用 setTimeout()

延迟限制

定时器是可以嵌套的;这意味着,setInterval() 的回调中可以嵌入对 setInterval() 的调用以创建另一个定时器,即使第一个定时器还在运行。为了减轻这对性能产生的潜在影响,一旦定时器嵌套超过 5 层深度,浏览器将自动强制设置定时器的最小时间间隔为 4 毫秒。如果尝试将深层嵌套中调用 setInterval() 的延迟设定为小于 4 毫秒的值,其将被固定为 4 毫秒。

在某些情况下,浏览器可能会强制执行更严格的最小时间间隔限制,尽管这些情况是不常见的。另外,请注意每次调用回调函数之间经过的实际时间可能会比给定的 delay 长;有关的示例,请参见实际延时比设定值更久的原因

确保执行时间短于定时器时间间隔

如果你的代码逻辑执行时间可能比定时器时间间隔要长,建议你使用递归调用了 setTimeout() 的具名函数。例如,使用 setInterval() 以 5 秒的间隔轮询服务器,可能因网络延迟、服务器无响应以及许多其他的问题而导致请求无法在分配的时间内完成。因此,你可能会发现排队的 XHR 请求没有按顺序返回。

在这些场景下,应首选递归调用 setTimeout() 的模式:

js
(function loop() {
  setTimeout(function () {
    // 在这里编写代码逻辑

    loop();
  }, delay);
})();

在上面的代码片段中,声明了一个具名函数 loop(),并被立即执行。loop() 在完成代码逻辑的执行后,会在内部递归调用 setTimeout()。虽然该模式不保证以固定的时间间隔执行,但它保证了上一次定时任务在递归前已经完成。

规范

规范
HTML
# dom-setinterval-dev

浏览器兼容性

参见