IntersectionObserver: takeRecords() メソッド

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.

IntersectionObservertakeRecords() メソッドは IntersectionObserverEntry オブジェクトの配列を返します。それぞれのオブジェクトは、前回明示的にこのメソッドが呼び出されるか、暗黙的にオブザーバーのコールバックが自動的に呼び出されて交差状態がチェックされたときから変更されたそれぞれの対象要素を表します。

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

構文

js
takeRecords()

引数

なし。

返値

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

仕様書

Specification
Intersection Observer
# dom-intersectionobserver-takerecords

ブラウザーの互換性

BCD tables only load in the browser

関連情報