IntersectionObserver.thresholds

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.

La propriété en lecture seule thresholds de l'interface IntersectionObserver retourne la liste des seuils d'intersection spécifiés lors de l'instanciation avec IntersectionObserver(). Si un seul seuil a été fourni lors de l'instanciation de l'objet, cette propriété sera un tableau contenant cette unique valeur numérique.

Voir la section sur les seuils pour apprendre comment fonctionnent les seuils d'intersection.

Syntaxe

js
thresholds = IntersectionObserver.thresholds;

Valeur

Un tableau de seuils d'intersection, spécifiés lors de l'instanciation via options.threshold. Si un seul seuil a été fourni, sans être donné dans un tableau (avec une valeur numérique « brute » donc), la valeur de la propriété sera un tableau contenant cette unique valeur. Quel qu'ait été l'ordre du tableau fourni à l'origine, celui fournit par thresholds sera trié par ordre croissant.

Si aucune option threshold n'est fournie lors de l'instanciation avec IntersectionObserver(), la valeur par défaut de thresholds est définie à [0].

Attention : Bien que l'objet d'options qu'on peut spécifier à la création d'un IntersectionObserver possède une propriété champ nommée threshold, cette propriété-ci s'appelle thresholds (avec un « s » supplémentaire donc). Cela peut porter à confusion. Si vous utilisez thresholds par erreur comme nom pour la propriété de l'objet options, le tableau porté par 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.

Spécifications

Specification
Intersection Observer
# dom-intersectionobserver-thresholds

Compatibilité des navigateurs

BCD tables only load in the browser