---
title: IntersectionObserver.takeRecords()
slug: Web/API/IntersectionObserver/takeRecords
tags:
  - API
  - Intersection Observer
  - Intersection Observer API
  - IntersectionObserver
  - Method
  - NeedsExample
  - Reference
  - takeRecords
translation_of: Web/API/IntersectionObserver/takeRecords
---
<div>{{APIRef("Intersection Observer API")}}</div>

<p class="summary">La méthode <code><strong>takeRecords()</strong></code> de l'interface <a href="/fr/docs/Web/API/IntersectionObserver"><code>IntersectionObserver</code></a> renvoie un tableau d'objets <a href="/fr/docs/Web/API/IntersectionObserverEntry"><code>IntersectionObserverEntry</code></a>, un pour chaque élément ciblé qui a subi un changement d'intersection depuis la dernière vérification des intersections, soit explicitement par un appel à cette méthode, soit implicitement par un appel automatique à la fonction de rappel de l'observateur.</p>

<div class="notecard note">
  <p><b>Note :</b></p>
  <p>Si vous utilisez la fonction de rappel pour surveiller ces changements, vous n'avez pas besoin d'appeler cette méthode. L'appel de cette méthode efface la liste des intersections en attente, de sorte que la fonction de rappel ne sera pas exécutée.</p>
</div>

<h2 id="syntax">Syntaxe</h2>

<pre class="syntaxbox"><var>intersectionObserverEntries</var> = <var>intersectionObserver</var>.takeRecords();</pre>

<h3 id="parameters">Paramètres</h3>

<p>Aucun.</p>

<h3 id="return_value">Valeur de retour</h3>

<p>Un tableau d'objets <a href="/fr/docs/Web/API/IntersectionObserverEntry"><code>IntersectionObserverEntry</code></a>, un pour chaque élément cible dont l'intersection avec la racine a changé depuis la dernière vérification des intersections.</p>

<h2 id="specifications">Spécifications</h2>

<table class="standard-table">
  <thead>
    <tr>
      <th scope="col">Spécification</th>
      <th scope="col">Statut</th>
      <th scope="col">Commentaire</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>
        {{SpecName('IntersectionObserver','#dom-intersectionobserver-takerecords','IntersectionObserver.takeRecords()')}}
      </td>
      <td>{{Spec2('IntersectionObserver')}}</td>
      <td>Définition initiale.</td>
    </tr>
  </tbody>
</table>

<h2 id="browser_compatibility">Compatibilité des navigateurs</h2>

<p>{{Compat("api.IntersectionObserver.takeRecords")}}</p>

<h2 id="see_also">Voir aussi</h2>

<ul>
  <li><a href="/en-US/docs/Web/API/Intersection_Observer_API">L'API <i>Intersection Observer</i></a></li>
</ul>