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

CKTIS / JavaScript

NON bit à bit (~)

L’opérateur unaire ~ inverse les bits d’une valeur numérique. Pour Number, il opère sur un entier signé de 32 bits ; pour BigInt, il ne limite pas la valeur à 32 bits. Il ne faut pas le confondre avec le NON logique (!).

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

~expression

L’opérateur ~expression inverse chaque bit : 0 devient 1 et 1 devient 0. Il effectue d’abord une conversion ToNumeric, puis choisit l’opération pour Number ou BigInt. Le résultat conserve le type numérique choisi. À l’inverse, ! effectue une négation logique et renvoie une valeur de type boolean.

Pour Number, l’opérande subit une conversion ToInt32 : la partie fractionnaire est tronquée en direction de zéro et la valeur revient dans la plage des entiers signés de 32 bits. NaN, les deux infinis et les deux zéros deviennent 0. Les 32 bits sont ensuite inversés. Ainsi, ~5 produit -6, ~5.9 produit également -6, et ~4294967296 produit -1. Ici, l’identité ~x = -x - 1 s’applique à la valeur après conversion ToInt32, et non à une valeur Number initiale quelconque.

Pour BigInt, il n’y a pas de troncature à 32 bits. L’opération correspond à la représentation en complément à deux avec une extension de signe illimitée et vérifie ~x === -x - 1n. Par exemple, ~5n produit -6n.

La conversion permet notamment d’écrire ~"5", qui produit -6, mais un opérande de type Symbol provoque une TypeError. L’expression ~~x n’est pas une méthode générale d’arrondi : pour Number, elle renvoie ToInt32(x), donc les grandes valeurs peuvent revenir par bouclage ; pour BigInt, elle renvoie la valeur d’origine. L’exemple illustre ces différences sans dépendre du DOM ni d’autres API Web.

Exemples

const value = 5;
console.log(~value);
console.log(~5n === -6n);
console.log(~5.9);
console.log(~4294967296);
console.log(~~5.9);

Résultat

-6
true
-6
-1
5

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources