Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Number.parseInt()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.
La méthodeNumber.parseInt() analyse et convertit une chaine de caractères, fournie en argument, en un entier dans la base souhaitée.
Dans cet article
Exemple interactif
function roughScale(x, base) { const parsed = Number.parseInt(x, base); if (Number.isNaN(parsed)) { return 0; } return parsed * 100;}console.log(roughScale(" 0xF", 16));// Expected output: 1500console.log(roughScale("321", 2));// Expected output: 0Syntaxe
Number.parseInt(chaîne [, base])Paramètres
chaîneLa valeur à convertir. Si
chainen'est pas une chaîne de caractères, elle sera convertie auparavant. Les blancs qui préfixent la chaîne sont ignorés.baseFacultatifParamè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 valeurNaN qui sera renvoyée.
Description
Voir la pageparseInt() pour plus de détails et d'exemples. Cette méthode se comporte de façon identique à la fonction globaleparseInt() et fait partie d'ECMAScript 2015 (dans le but de « modulariser » les méthodes globales) et on aura :
Number.parseInt === parseInt; // trueProthè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 :
if (Number.parseInt === undefined) { Number.parseInt = parseInt;}Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-number.parseint> |
Compatibilité des navigateurs
Voir aussi
- L'objet
Numberauquel appartient cette fonction. - La méthode
parseInt()de l'objet global.