javascript-obfuscator · jbetala7 · Aug 7, 2025 · Nov 30, 2025 · Nov 30, 2025
diff --git a/README.md b/README.md
@@ -361,6 +361,7 @@ Following options are available for the JS Obfuscator:
     inputFileName: '',
     log: false,
     numbersToExpressions: false,
+    numbersToHexadecimal: true,
     optionsPreset: 'default',
     renameGlobals: false,
     renameProperties: false,
@@ -425,6 +426,7 @@ Following options are available for the JS Obfuscator:
     --ignore-imports <boolean>
     --log <boolean>
     --numbers-to-expressions <boolean>
+    --numbers-to-hexadecimal <boolean>
     --options-preset <string> [default, low-obfuscation, medium-obfuscation, high-obfuscation]
     --rename-globals <boolean>
     --rename-properties <boolean>
@@ -868,6 +870,26 @@ const foo = 1234;
 const foo=-0xd93+-0x10b4+0x41*0x67+0x84e*0x3+-0xff8;
 ```
 
+### `numbersToHexadecimal`
+Type: `boolean` Default: `true`
+
+Enables conversion of integer numbers to hexadecimal format.
+
+When `true`, integer numbers like `1000` will be converted to `0x3e8`.
+When `false`, numbers remain in their original decimal format.
+
+Example: 
+```ts
+// input
+setInterval(sendHeartbeat, 1000 * 60 * 1);
+
+// output with numbersToHexadecimal: true
+setInterval(sendHeartbeat, 0x3e8 * 0x3c * 0x1);
+
+// output with numbersToHexadecimal: false  
+setInterval(sendHeartbeat, 1000 * 60 * 1);
+```
+
 ### `optionsPreset`
 Type: `string` Default: `default`
 

diff --git a/src/cli/JavaScriptObfuscatorCLI.ts b/src/cli/JavaScriptObfuscatorCLI.ts
@@ -282,6 +282,10 @@ export class JavaScriptObfuscatorCLI implements IInitializable {
                 '--numbers-to-expressions <boolean>', 'Enables numbers conversion to expressions',
                 BooleanSanitizer
             )
+            .option(
+                '--numbers-to-hexadecimal <boolean>', 'Enables conversion of integer numbers to hexadecimal format',
+                BooleanSanitizer
+            )
             .option(
                 '--options-preset <string>',
                 'Allows to set options preset. ' +

diff --git a/src/custom-code-helpers/CustomCodeHelperObfuscator.ts b/src/custom-code-helpers/CustomCodeHelperObfuscator.ts
@@ -48,6 +48,7 @@ export class CustomCodeHelperObfuscator implements ICustomCodeHelperObfuscator {
                 identifierNamesGenerator: this.options.identifierNamesGenerator,
                 identifiersDictionary: this.options.identifiersDictionary,
                 numbersToExpressions: this.options.numbersToExpressions,
+                numbersToHexadecimal: this.options.numbersToHexadecimal,
                 simplify: this.options.simplify,
                 seed: this.randomGenerator.getRawSeed(),
                 ...additionalOptions

diff --git a/src/interfaces/options/IOptions.ts b/src/interfaces/options/IOptions.ts
@@ -31,6 +31,7 @@ export interface IOptions {
     readonly inputFileName: string;
     readonly log: boolean;
     readonly numbersToExpressions: boolean;
+    readonly numbersToHexadecimal: boolean;
     readonly optionsPreset: TOptionsPreset;
     readonly renameGlobals: boolean;
     readonly renameProperties: boolean;

diff --git a/src/node-transformers/converting-transformers/NumberLiteralTransformer.ts b/src/node-transformers/converting-transformers/NumberLiteralTransformer.ts
@@ -88,7 +88,7 @@ export class NumberLiteralTransformer extends AbstractNodeTransformer {
         if (this.numberLiteralCache.has(literalValue)) {
             rawValue = <string>this.numberLiteralCache.get(literalValue);
         } else {
-            if (NumberUtils.isCeil(literalValue)) {
+            if (this.options.numbersToHexadecimal && NumberUtils.isCeil(literalValue)) {
                 rawValue = NumberUtils.toHex(literalValue);
             } else {
                 rawValue = String(literalValue);

diff --git a/src/options/Options.ts b/src/options/Options.ts
@@ -212,6 +212,12 @@ export class Options implements IOptions {
     @IsBoolean()
     public readonly numbersToExpressions!: boolean;
 
+    /**
+     * @type {boolean}
+     */
+    @IsBoolean()
+    public readonly numbersToHexadecimal!: boolean;
+
     /**
      * @type {TOptionsPreset}
      */

diff --git a/src/options/presets/Default.ts b/src/options/presets/Default.ts
@@ -32,6 +32,7 @@ export const DEFAULT_PRESET: TInputOptions = Object.freeze({
     inputFileName: '',
     log: false,
     numbersToExpressions: false,
+    numbersToHexadecimal: true,
     optionsPreset: OptionsPreset.Default,
     renameGlobals: false,
     renameProperties: false,

diff --git a/src/options/presets/NoCustomNodes.ts b/src/options/presets/NoCustomNodes.ts
@@ -29,6 +29,7 @@ export const NO_ADDITIONAL_NODES_PRESET: TInputOptions = Object.freeze({
     inputFileName: '',
     log: false,
     numbersToExpressions: false,
+    numbersToHexadecimal: true,
     renameGlobals: false,
     renameProperties: false,
     renamePropertiesMode: RenamePropertiesMode.Safe,

diff --git a/...rmers/converting-transformers/number-literal-transformer/NumberLiteralTransformer.spec.ts b/...rmers/converting-transformers/number-literal-transformer/NumberLiteralTransformer.spec.ts
@@ -52,4 +52,52 @@ describe('NumberLiteralTransformer', () => {
             assert.match(obfuscatedCode, regExp);
         });
     });
+
+    describe('numbersToHexadecimal option', () => {
+        describe('when numbersToHexadecimal is true (default)', () => {
+            const regExp: RegExp = /^setInterval\(sendHeartbeat, 0x3e8 \* 0x3c \* 0x1\);$/;
+
+            let obfuscatedCode: string;
+
+            before(() => {
+                const code: string = 'setInterval(sendHeartbeat, 1000 * 60 * 1);';
+
+                obfuscatedCode = JavaScriptObfuscator.obfuscate(
+                    code,
+                    {
+                        ...NO_ADDITIONAL_NODES_PRESET,
+                        numbersToHexadecimal: true,
+                        compact: false
+                    }
+                ).getObfuscatedCode();
+            });
+
+            it('should convert numbers to hexadecimal', () => {
+                assert.match(obfuscatedCode, regExp);
+            });
+        });
+
+        describe('when numbersToHexadecimal is false', () => {
+            const regExp: RegExp = /^setInterval\(sendHeartbeat, 1000 \* 60 \* 1\);$/;
+
+            let obfuscatedCode: string;
+
+            before(() => {
+                const code: string = 'setInterval(sendHeartbeat, 1000 * 60 * 1);';
+
+                obfuscatedCode = JavaScriptObfuscator.obfuscate(
+                    code,
+                    {
+                        ...NO_ADDITIONAL_NODES_PRESET,
+                        numbersToHexadecimal: false,
+                        compact: false
+                    }
+                ).getObfuscatedCode();
+            });
+
+            it('should keep numbers in decimal format', () => {
+                assert.match(obfuscatedCode, regExp);
+            });
+        });
+    });
 });