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