Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Number : propriété statique POSITIVE_INFINITY

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété statique Number.POSITIVE_INFINITY représente la valeur d'infini positif.

Exemple interactif

function checkNumber(bigNumber) {
  if (bigNumber === Number.POSITIVE_INFINITY) {
    return "Représente un nombre comme Infinity";
  }
  return bigNumber;
}

console.log(checkNumber(Number.MAX_VALUE));
// Sortie attendue : 1.7976931348623157e+308

console.log(checkNumber(Number.MAX_VALUE * 2));
// Sortie attendue : "Représente un nombre comme Infinity"

Valeur

La même que la valeur de la propriété native Infinity.

Attributs de Number : propriété statique POSITIVE_INFINITY
ÉcrivableNon
ÉnumérableNon
ConfigurableNon

Description

La valeur Number.POSITIVE_INFINITY se comporte légèrement différemment de l'infini au sens mathématique :

  • Toute valeur positive, y compris POSITIVE_INFINITY, multipliée par POSITIVE_INFINITY est POSITIVE_INFINITY.
  • Toute valeur négative, y compris NEGATIVE_INFINITY, multipliée par POSITIVE_INFINITY est NEGATIVE_INFINITY.
  • Tout nombre positif divisé par POSITIVE_INFINITY est zéro positif (angl.) (comme défini dans IEEE 754 (angl.)).
  • Tout nombre négatif divisé par POSITIVE_INFINITY est zéro négatif (angl.) (comme défini dans IEEE 754 (angl.)).
  • Le zéro multiplié par POSITIVE_INFINITY est NaN.
  • NaN multiplié par POSITIVE_INFINITY est NaN.
  • POSITIVE_INFINITY, divisé par toute valeur négative sauf NEGATIVE_INFINITY, est NEGATIVE_INFINITY.
  • POSITIVE_INFINITY, divisé par toute valeur positive sauf POSITIVE_INFINITY, est POSITIVE_INFINITY.
  • POSITIVE_INFINITY, divisé par NEGATIVE_INFINITY ou POSITIVE_INFINITY, est NaN.
  • Number.POSITIVE_INFINITY > x est vrai pour tout nombre x qui n'est pas POSITIVE_INFINITY.

Vous pouvez utiliser la propriété Number.POSITIVE_INFINITY pour indiquer une condition d'erreur qui retourne un nombre fini en cas de succès. Notez, cependant, que NaN est plus approprié dans un tel cas.

Comme POSITIVE_INFINITY est une propriété statique de Number, vous l'utilisez toujours comme Number.POSITIVE_INFINITY, plutôt que comme une propriété d'une valeur numérique.

Exemples

Utiliser POSITIVE_INFINITY

Dans l'exemple qui suit, la variable grandNombre se voit affecter une valeur supérieure à la valeur maximale. Lorsque l'instruction if s'exécute, grandNombre a la valeur Infinity, donc grandNombre est défini sur une valeur plus gérable avant de continuer.

js
let grandNombre = Number.MAX_VALUE * 2;

if (grandNombre == Number.POSITIVE_INFINITY) {
  grandNombre = retournerUnNombreFini();
}

Spécifications

Spécification
ECMAScript® 2027 Language Specification
# sec-number.positive_infinity

Compatibilité des navigateurs

Voir aussi