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.

IntersectionObserverunobserve() メソッドは、 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

関連情報