Number.parseInt()

La méthode Number.parseInt() analyse et convertit une chaine de caractères, fournie en argument, en un entier dans la base souhaitée.

Syntaxe

Number.parseInt(chaîne [, base])

Paramètres

chaîne
La valeur à convertir. Si chaine n'est pas une chaîne de caractères, elle sera convertie auparavant. Les blancs qui préfixent la chaîne sont ignorés.
base Facultatif
Paramètre optionnel. Un entier représentant la base dans laquelle est représentée la valeur de la chaîne. Il faut toujours spécifier ce paramètre. Cela permet que le code ne soit pas ambigü et permet de garantir un comportement prévisible. En effet les différentes implémentations peuvent fournir des résultats différents lorsque la base n'est pas spécifiée.

Valeur de retour

Un entier construit à partir de l'analyse de la chaîne de caractères passée en argument. Si le premier caractère ne permet pas de conversion numérique, c'est la valeur NaN qui sera renvoyée.

Description

Voir la page parseInt() pour plus de détails et d'exemples. Cette méthode se comporte de façon identique à la fonction globale parseInt() et fait partie d'ECMAScript 2015 (dans le but de « modulariser » les méthodes globales) et on aura :

Number.parseInt === parseInt; // true

Prothèse d'émulation (polyfill)

Si on souhaite bénéficier de cette fonction dans un environnement qui n'en dispose pas, on pourra donc l'émuler de la façon suivante :

Number.parseInt = parseInt;

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Number.parseInt' dans cette spécification.
Standard Définition initiale.
ECMAScript 2017 Draft (ECMA-262)
La définition de 'Number.parseInt' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) 25 (25) Pas de support (Oui) Pas de support
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple Pas de support 25 (25) Pas de support Pas de support Pas de support

Voir aussi

  • L'objet Number auquel appartient cette fonction.
  • La méthode parseInt() de l'objet global.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, RyDroid, tforgione
 Dernière mise à jour par : SphinxKnight,