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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
unobserve

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

関連情報