IntersectionObserver.unobserve()

IntersectionObserver の unobserve() メソッドは、 IntersectionObserver に指定された対象要素の監視を停止するよう指示します。

構文

unobserve(target)

引数

target

監視を停止する Element を指定します。指定された要素を監視していない場合、このメソッドは何もせず、例外も発生しません。

返値

なし (undefined)。

例

このスニペットは、オブザーバーが作成され、要素が監視され、そして監視が終了する様子を示しています。

const observer = new IntersectionObserver(callback);
observer.observe(document.getElementById("elementToObserve"));

// …

observer.unobserve(document.getElementById("elementToObserve"));

仕様書

Specification
Intersection Observer
# dom-intersectionobserver-unobserve

ブラウザーの互換性

BCD tables only load in the browser

関連情報