--- title: IntersectionObserver.thresholds slug: Web/API/IntersectionObserver/thresholds tags: - API - Intersection Observer - Intersection Observer API - IntersectionObserver - Propriété translation_of: Web/API/IntersectionObserver/thresholds ---
{{APIRef("Intersection Observer API")}}{{draft}}{{SeeCompatTable}}

La propriété en lecture seule thresholds de l'interface {{domxref("IntersectionObserver")}} retourne la liste des seuils d'intersection spécifiés lorsque l'observateur a été instancié avec {{domxref("IntersectionObserver.IntersectionObserver", "IntersectionObserver()")}}. Si un unique ratio seuil a été donné comme valeur numérique à l'instanciation de l'objet, cette valeur sera un tableau contenant uniquement cette valeur.

Voir {{SectionOnPage("/fr-FR/docs/Web/API/Intersection_Observer_API", "Thresholds")}} pour apprendre comment fonctionnent les seuils d'intersection.

Syntaxe

let thresholds = IntersectionObserver.thresholds;

Valeur

Un tableau de seuils d'intersection, originellement spécifié au moyen de la propriété threshold à l'instanciation d'un observateur. Si un unique observateur a été spécifié, sans être donné dans un tableau (valeur numérique), cette valeur se traduite comme un tableau d'un élément la contenant. Quelque fut l'ordre de votre tableau original de threshold, il sera trié par ordre croissant.

Si aucune option threshold n'est donnée lorsque IntersectionObserver() est utilisé pour instantier l'observateur, la valeur de thresholds est par défaut définie à [0].

Attention! Bien que l'objet d'options que vous pouvez spécifier lorsque vous créez un {{domxref("IntersectionObserver")}} a un champ nommé {{domxref("IntersectionObserver.threshold", "threshold")}}, cette propriété-ci s'appelle thresholds. Cela peut porter à confusion. Si vous utilisez thresholds par erreur comme nom du champ votre objet d'options, le tableau de thresholds va se retrouver égal à [0.0], ce qui n'est probablement pas ce à quoi vous vous attendiez. Le déboguage n'en sera que plus chaotique.

Exemple

// Instanciation d'un observateur, c'est l'objet d'options qui contient le tableau des seuils (propriété threshold)
observateur = new IntersectionObserver(fonctionRappel, optionsObservateur)

Puis faire simplement :

observateur.thresholds

Pour afficher la liste des seuils fournie à l'initialisation.

Spécifications

Specification Status Comment
{{SpecName('IntersectionObserver', '#dom-intersectionobserver-thresholds', 'IntersectionObserver.thresholds')}} {{Spec2('IntersectionObserver')}} Initial definition

Compatibilité des navigateurs

{{Compat("api.IntersectionObserver.thresholds")}}