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.