IntersectionObserver: takeRecords() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2019年3月以降、すべてのブラウザーで利用可能です。
takeRecords() は IntersectionObserver インターフェイスのメソッドで、 IntersectionObserverEntry オブジェクトの配列を返します。それぞれのオブジェクトは、前回明示的にこのメソッドが呼び出されるか、暗黙的にオブザーバーのコールバックが自動的に呼び出されて交差状態がチェックされたときから変更されたそれぞれの対象要素を表します。
メモ: コールバックを使用してこれらの変更を監視している場合は、このメソッドを呼び出す必要はありません。 このメソッドを呼び出すと処理待ちの交差リストをクリアしてしまうため、コールバックが実行されません。
構文
js
takeRecords()
引数
なし。
返値
ルートとの交差状態が最後に調べられた時点以降に変更された対象要素ごとに 1 つずつ IntersectionObserverEntry オブジェクトが入った配列。
仕様書
| 仕様書 |
|---|
| Intersection Observer> # dom-intersectionobserver-takerecords> |