База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

`disconnectedCallback()` на персонализиран елемент

Използвайте `disconnectedCallback()`, за да освободите ресурсите, свързани с присъствието на персонализиран елемент в документа, без да възпрепятствате повторното му свързване.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

disconnectedCallback() е незадължителен метод на екземпляра, част от жизнения цикъл на регистриран персонализиран елемент. Браузърът го извиква без аргументи, като this сочи към елемента, когато той загуби връзката си с документ, например при премахване на негов предшественик. Скриването на елемента или създаването му без вмъкване не задейства метода. Той е част от уеб платформата, а не от ECMAScript 2024.

Започвайте дейностите, зависещи от връзката с документа, в connectedCallback() и ги прекратявайте в disconnectedCallback(): спирайте таймерите, прекратявайте наблюдението и премахвайте слушателите за събития от външни обекти. При removeEventListener() използвайте същия целеви обект, тип събитие, обект на функцията и стойност на capture, както при регистрирането. Прекъсването на връзката не унищожава екземпляра: той може да се свърже отново, затова почистването трябва да може да се повтаря безопасно.

Обикновено преместване в рамките на документ чрез Node.insertBefore() може да задейства disconnectedCallback(), а след това connectedCallback(). Ако браузърът поддържа Element.moveBefore() и елементът дефинира connectedMoveCallback(), преместване със запазване на състоянието чрез този API извиква този метод вместо другите два. Проверете поддръжката в целевите браузъри.

Примери

<!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>

Резултат

1, 1, 2, 2

Запазете целия код в HTML файл и го отворете в браузър. При двете вмъквания се използва един и същ екземпляр. Събитието `ping` увеличава брояча само докато елементът е свързан с документа. Очакваният изход е `1, 1, 2, 2`.

Свързани уроци

  • JavaScript · Урок 39 · Средно · Версия: 3

Източници