Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Number.parseInt : analyser un préfixe entier

Number.parseInt convertit son argument en texte et renvoie l’entier du plus long préfixe valide dans la base choisie, ou NaN.

Version : ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

Number.parseInt(string, radix)

Number.parseInt(value, radix) applique d’abord ToString, retire les espaces initiaux et reconnaît un signe + ou - facultatif. radix passe par ToInt32 : après conversion, 0 choisit la base par défaut, 2..36 est valide et toute autre valeur donne NaN. L’analyse s’arrête avant le premier chiffre interdit dans cette base ; "15px" en base 10 donne donc 15 plutôt qu’une erreur.

Avec la base par défaut, 10 est utilisée, sauf si le préfixe 0x/0X sélectionne 16. Les préfixes 0b et 0o ne sont pas reconnus ici ; une base explicite est plus sûre pour des données d’entrée. Sans chiffre valide consommé, le résultat est NaN ; un résultat -0 garde son signe. Un très grand entier mathématique est renvoyé comme Number et peut être arrondi.

Number.parseInt existe depuis ECMAScript 2015, est la même fonction que le parseInt global et n’est pas un constructeur. BigInt est d’abord converti en texte et peut perdre en précision ; Symbol lève TypeError, tandis que des objets comme valeur ou base peuvent exécuter leur conversion et propager son exception. Pour exiger une correspondance complète, validez d’abord tout le texte.

Exemples

console.log(Number.parseInt("42", 10), Number.parseInt("0x10", 16), Number.parseInt("101", 2));
console.log(Number.parseInt("15px", 10), Number.parseInt("bad", 10));
console.log(Number.parseInt("0x10"), Number.parseInt("0x10", 10));
console.log(Object.is(Number.parseInt("-0", 10), -0), Number.parseInt === parseInt);
console.log(Number.parseInt("10", 1), Number.parseInt("10", 37));
try { Number.parseInt(Symbol("x"), 10); } catch (error) { console.log(error instanceof TypeError); }

Résultat

42 16 5
15 NaN
16 0
true true
NaN NaN
true

Number.parseInt → bases explicites, préfixe 0x, NaN et signe de -0

Sources