Quickstart

This tutorial takes a JavaScript file, obfuscates it, and runs the generated file to confirm that its result did not change.

webfuscator exposes a JavaScript API, not a command-line interface. The build script below handles file reads and writes.

Prerequisites

Node.js ^22.18.0 || >=24.11.0
An ESM project or an .mjs build script

Install webfuscator

Add the package as a development dependency.

npm install --save-dev webfuscator

pnpm add --save-dev webfuscator

Create a JavaScript input

Save this program as src/input.js.

src/input.js

export default function greet(name) {
  const message = `Hello, ${name}!`
  return message
}

Create the build script

Save this script as obfuscate.mjs. It reads the input, calls obfuscate, and writes the returned source.

obfuscate.mjs

import { mkdir, readFile, writeFile } from 'node:fs/promises'

import { obfuscate } from 'webfuscator'

const inputPath = 'src/input.js'
const outputPath = 'build/input.js'
const source = await readFile(inputPath, 'utf8')
const output = obfuscate(source, {
  minify: true,
  seed: 42,
  transforms: { renameIdentifiers: true },
})

await mkdir('build', { recursive: true })
await writeFile(outputPath, output)

Build and run the result

Run the build script, then execute the generated JavaScript.

Terminal

node obfuscate.mjs
node --input-type=module --eval "const { default: greet } = await import('./build/input.js'); console.log(greet('world'))"

The generated program prints the same value as the input:

Output

Hello, world!

You now have a repeatable obfuscation step. Running it again with the same input, options, package version, and Node.js version produces the same file.

Add it to your package scripts

package.json

{
  "scripts": {
    "obfuscate": "node obfuscate.mjs"
  }
}

Run the script with your package manager after your compiler or bundler emits plain JavaScript.

webfuscator does not parse TypeScript or JSX and does not emit source maps. Compile syntax extensions first, then obfuscate the JavaScript output.

Next steps

Configure transforms

Decide which removal, lowering, naming, and literal passes belong in your build.

Review every option

Check accepted types, defaults, and transform-specific configuration.

Get started

Reference

Support

Prerequisites

Add it to your package scripts

Next steps

Configure transforms

Review every option

​Prerequisites

​Add it to your package scripts

​Next steps

Configure transforms

Review every option

Prerequisites

Add it to your package scripts

Next steps