setInterval()

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

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

语法

js
var intervalID = setInterval(func, [delay, arg1, arg2, ...]);
var intervalID = setInterval(function[, delay]);
var intervalID = setInterval(code, [delay]);

参数

func

要重复调用的函数,每经过指定 delay 毫秒后执行一次。第一次调用发生在 delay 毫秒之后。

code

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

delay

是每次延迟的毫秒数(一秒等于 1000 毫秒),函数的每次调用会在该延迟之后发生。如果未指定,则其默认值为 0。参见下方的延迟限制以了解详细的 delay 的取值范围。

arg1, ..., argN 可选

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

返回值

返回值 intervalID 是一个非零数值,用来标识通过 setInterval() 创建的定时器,这个值可以用来作为 clearInterval() 的参数来清除对应的定时器。

值得注意的是,setInterval()setTimeout() 共享同一个 ID 池,并且 clearInterval()clearTimeout() 在技术上是可互换使用的。但是,我们应该匹配使用 clearInterval()clearTimeout(),以避免代码杂乱无章,并增强代码的可维护性。

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

示例

例 1:基本语法

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

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

function myCallback(a, b) {
  // Your code here
  // Parameters are purely optional.
  console.log(a);
  console.log(b);
}

例 2:两种颜色的切换

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

HTML

html
<div id="my_box">
  <h3>Hello World</h3>
</div>
<button id="start">Start</button>
<button id="stop">Stop</button>

CSS

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

JavaScript

js
// variable to store our intervalID
let nIntervId;

function changeColor() {
  // check if already an interval has been set up
  if (!nIntervId) {
    nIntervId = setInterval(flashText, 1000);
  }
}

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

function stopTextColor() {
  clearInterval(nIntervId);
  // release our intervalID from the variable
  nIntervId = null;
}

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

结果

参见:clearInterval()

“this”的问题

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

解释

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

js
myArray = ["zero", "one", "two"];

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

myArray.myMethod(); // prints "zero,one,two"
myArray.myMethod(1); // prints "one"
setTimeout(myArray.myMethod, 1000); // prints "[object Window]" after 1 second
setTimeout(myArray.myMethod, 1500, "1"); // prints "undefined" after 1,5 seconds
// passing the 'this' object with .call won't work
// because this will change the value of this inside setTimeout itself
// while we want to change the value of this inside myArray.myMethod
// in fact, it will be an error because setTimeout code expects this to be the window object:
setTimeout.call(myArray, myArray.myMethod, 2000); // error: "NS_ERROR_XPC_BAD_OP_ON_WN_PROTO: Illegal operation on WrappedNative prototype object"
setTimeout.call(myArray, myArray.myMethod, 2500, 2); // same error

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

一个可能的解决方案

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

如果你需要支持 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 () {
    // Your logic here

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

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

规范

Specification
HTML Standard
# dom-setinterval-dev

浏览器兼容性

BCD tables only load in the browser

参见