Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

`disconnectedCallback()` de un elemento personalizado

Usa `disconnectedCallback()` para liberar los recursos ligados a la conexión de un elemento personalizado a un documento, sin impedir que vuelva a conectarse.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

class MyElement extends HTMLElement {
  disconnectedCallback() {
    // Release resources tied to the current connection.
  }
}
customElements.define("my-element", MyElement);

disconnectedCallback() es un método de instancia opcional del ciclo de vida de un elemento personalizado registrado. El navegador lo llama sin argumentos y con el elemento como valor de this cuando este pierde su conexión con un documento, por ejemplo al retirar un ancestro. Ocultar el elemento o crearlo sin insertarlo no activa la llamada. El método pertenece a la plataforma web, no a ECMAScript 2024.

Inicia el trabajo ligado a la conexión en connectedCallback() y detenlo en disconnectedCallback(): cancela temporizadores, desconecta observadores y elimina escuchas de eventos de destinos externos. Para removeEventListener(), usa el mismo destino, tipo de evento, objeto función y valor de capture que al registrar la escucha. La desconexión no destruye la instancia: puede volver a conectarse, así que la limpieza debe poder repetirse sin problemas.

Un movimiento habitual dentro de un documento con Node.insertBefore() puede activar disconnectedCallback() y, después, connectedCallback(). Si el navegador admite Element.moveBefore() y el elemento define connectedMoveCallback(), un movimiento que conserva el estado con esa API llama a ese método en lugar de los otros dos. Comprueba la compatibilidad en los navegadores de destino.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Custom element disconnection</title>
</head>
<body>
  <pre id="result"></pre>
  <script>
    const source = new EventTarget();
    let count = 0;

    class CktisPingCounter extends HTMLElement {
      #onPing = () => { count += 1; };

      connectedCallback() {
        source.addEventListener("ping", this.#onPing);
      }

      disconnectedCallback() {
        source.removeEventListener("ping", this.#onPing);
      }
    }

    customElements.define("cktis-ping-counter", CktisPingCounter);
    const counter = document.createElement("cktis-ping-counter");
    const counts = [];
    const probe = () => {
      source.dispatchEvent(new Event("ping"));
      counts.push(count);
    };

    document.body.append(counter);
    probe();
    counter.remove();
    probe();
    document.body.append(counter);
    probe();
    counter.remove();
    probe();

    const output = counts.join(", ");
    document.getElementById("result").textContent = output;
    console.log(output);
  </script>
</body>
</html>

Resultado

1, 1, 2, 2

Guarda el código completo en un archivo HTML y ábrelo en un navegador. Las dos inserciones usan la misma instancia. Un evento `ping` solo incrementa el contador cuando el elemento está conectado. La salida esperada es `1, 1, 2, 2`.

Lecciones relacionadas

  • JavaScript · Lección 39 · Intermedio · Versión: 3

Fuentes