IntersectionObserver: unobserve() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2019.

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

構文

js
unobserve(target)

引数

target

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

返値

なし (undefined)。

例

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

js
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

関連情報