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.

Exemple interactif

Syntaxe

js
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 :

js
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 :

js
if (Number.parseInt === undefined) {
  Number.parseInt = parseInt;
}

Spécifications

Specification
ECMAScript Language Specification
# sec-number.parseint

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

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