Number : méthode statique parseInt()
Baseline
Large disponibilité
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éthode statique Number.parseInt() analyse un argument de type chaîne de caractères et retourne un entier dans la base définie.
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));
// Sortie attendue : 1500
console.log(roughScale("321", 2));
// Sortie attendue : 0
Syntaxe
Number.parseInt(string)
Number.parseInt(string, radix)
Paramètres
string-
La valeur à analyser, convertie en chaîne de caractères. Les espaces blancs initiaux dans cet argument sont ignorés.
radixFacultatif-
Un entier compris entre
2et36qui représente la base (la base dans les systèmes de numération mathématiques) de la chaîne de caractères (string).Si la base (
radix) est indéfinie ou0, il est supposé être10, sauf lorsque le nombre commence par les paires d'unités de code0xou0X, auquel cas une base de16est supposée.
Valeur de retour
Un entier analysé depuis la chaîne de caractères (string) fournie.
Si la base (radix) est inférieure à 2 ou supérieure à 36, ou si le premier caractère non blanc ne peut pas être converti en nombre, NaN est retourné.
Exemples
Number.parseInt() et parseInt()
Cette méthode possède les mêmes fonctionnalités que la fonction native parseInt() :
Number.parseInt === parseInt; // true
Son objectif est la modularisation des objets natifs. Voir parseInt() pour plus de détails et d'exemples.
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification # sec-number.parseint |