aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/api/cleartimeout/index.html
blob: d86391e675de1c99739b4ef921b9458b19f5910d (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
---
title: window.clearTimeout
slug: Web/API/clearTimeout
translation_of: Web/API/WindowOrWorkerGlobalScope/clearTimeout
original_slug: Web/API/WindowOrWorkerGlobalScope/clearTimeout
---
<div>{{ApiRef}}</div>

<h2 id="Summary" name="Summary">Resumen</h2>

<p>Borra el retraso asignado por {{domxref("window.setTimeout","window.setTimeout()")}}.</p>

<h2 id="Syntax" name="Syntax">Sintaxis</h2>

<pre class="syntaxbox">window.clearTimeout(<em>timeoutID</em>)
</pre>

<ul>
 <li><code>timeoutID</code> es el ID del timeout que desee borrar, retornado por {{domxref("window.setTimeout","window.setTimeout()")}}.</li>
</ul>

<h2 id="Example" name="Example">Ejemplo</h2>

<p>Ejecute el script de abajo en el contexto de una página web y haga clic en la página una vez. Verá un mensaje emergente en un segundo. Si permanece haciendo clic en la página cada segundo, la alerta nunca aparece.</p>

<pre class="brush: js">var alarm = {
  remind: function(aMessage) {
    alert(aMessage);
    delete this.timeoutID;
  },

  setup: function() {
    this.cancel();
    var self = this;
    this.timeoutID = window.setTimeout(function(msg) {self.remind(msg);}, 1000, "Wake up!");
  },

  cancel: function() {
    if(typeof this.timeoutID == "number") {
      window.clearTimeout(this.timeoutID);
      delete this.timeoutID;
    }
  }
};
window.onclick = function() { alarm.setup() };</pre>

<h2 id="Notes" name="Notes">Notas</h2>

<p>Pasar un ID inválido a <code>clearTimeout</code> no tiene ningún efecto (y no lanza una excepción).</p>

<h2 id="Specification" name="Specification">Especificación</h2>

<p>DOM Nivel 0. Especificado en <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/timers.html#dom-windowtimers-cleartimeout">HTML5</a>.</p>

<h2 id="See_also" name="See_also">Vea también</h2>

<ul>
 <li><a href="/en-US/docs/JavaScript/Timers" title="JavaScript/Timers">JavaScript timers</a></li>
 <li>{{domxref("window.setTimeout")}}</li>
 <li>{{domxref("window.setInterval")}}</li>
 <li>{{domxref("window.clearInterval")}}</li>
 <li>{{domxref("window.requestAnimationFrame")}}</li>
 <li><a href="/en-US/docs/JavaScript/Timers/Daemons" title="JavaScript/Timers/Daemons"><em>Daemons</em> management</a></li>
</ul>