IntersectionObserver.takeRecords()

IntersectionObservertakeRecords() メソッドは、対象となる要素のうち、前回交差状態がチェックされた、すなわち明示的にこのメソッドが呼び出されたか、自動的にオブザーバーのコールバックが呼び出された以降に交差状態が変化した要素を、要素ごとに 1 つの IntersectionObserverEntry オブジェクトとした配列を返します。

メモ: コールバックを使用してこれらの変更を監視している場合は、このメソッドを呼び出す必要はありません。このメソッドを呼び出すと処理待ちの交差リストをクリアしてしまうため、コールバックが実行されません。

構文

js

takeRecords()

引数

なし。

返値

ルートとの交差状態が最後に調べられた時点以降に変更された対象要素ごとに 1 つの IntersectionObserverEntry オブジェクトとした配列。

仕様書

Specification
Intersection Observer
# dom-intersectionobserver-takerecords

ブラウザーの互換性

BCD tables only load in the browser

関連情報