Math.log()

La fonction Math.log() renvoie le logarithme naturel (aussi appelé logarithme népérien) d'un nombre, défini par :

x>0,Math.log(x)=ln(x)=le seul ytel queey=x\forall x > 0, \mathtt{\operatorname{Math.log}(x)} = \ln(x) = \text{the unique} \; y \; \text{such that} \; e^y = x

Syntaxe

Math.log(x)

Paramètres

x
Un nombre.

Valeur de retour

Le logarithme naturelle de la valeur passée en argument. Si cette valeur est négative, c'est NaN qui est renvoyé.

Description

Si la valeur de l'argument est négative, la valeur renvoyée sera NaN.

log() est une méthode statique de Math, elle doit toujours être utilisée avec la syntaxe Math.log(), elle ne doit pas être utilisée à partir d'un autre objet qui aurait été créé (Math n'est pas un constructeur). Si on veut utiliser les constantes données par les logarithmes naturels de 2 ou 10, on pourra utiliser les constantes Math.LN2 ou Math.LN10. De même pour les logarithmes en base 2 ou en base 10, on pourra utiliser Math.log2() or Math.log10().

Exemples

Utiliser Math.log()

Math.log(-1); // NaN, valeur en dehors de l'intervalle de définition
Math.log(0);  // -Infinity
Math.log(1);  // 0
Math.log(10); // 2.302585092994046

Utiliser Math.log pour construire un logarithme sur une autre base

La fonction suivante renvoie le logarithme de y en base x (c'est-à-dire logx y):

function getBaseLog(x, y) {
    return Math.log(y) / Math.log(x);
}

Si on exécute getBaseLog(10, 1000), on obtiendra 2.9999999999999996 en raison de l'arrondi du à la représentation en nombre flottant (le résultat exact étant 3).

Spécifications

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
La définition de 'Math.log' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Math.log' dans cette spécification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
La définition de 'Math.log' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, teoli, Jeremie, Mgjbot, Kyodev
 Dernière mise à jour par : SphinxKnight,