Report a bug

Before filing a bug, reduce the input to the smallest legal JavaScript program that still reproduces it. Small cases make transform and evaluation-order problems much easier to isolate.

Reduce the input

Remove application code and external dependencies until only the failing syntax and its observable result remain.

Include the complete options

Copy the exact object passed to obfuscate, including the seed and every transform override.

Record the environment

Include the webfuscator version, Node.js version, and operating system.

Compare observable behavior

Show the original and transformed return values, thrown error classes, mutations, or external calls. An output substring assertion alone does not prove a behavior bug.

Attach a runnable harness

Put the input, options, transformation, and comparison in one file when possible.

Reproduction template

reproduce.mjs

import assert from 'node:assert/strict'

import { obfuscate } from 'webfuscator'

const input = `
function run() {
  return 1
}
`
const options = {
  seed: 0,
}

const evaluate = (source) => new Function(`${source}; return run()`)()
const output = obfuscate(input, options)

assert.deepEqual(evaluate(output), evaluate(input))

Adjust the evaluator to capture the behavior that changed. If the program should throw, compare the error classes and relevant properties.

Replace private source and external dependencies with a synthetic case. Never post credentials, customer data, or proprietary bundles.

Open a GitHub issue

Include the reduced input, full options, environment, expected result, actual result, and runnable harness.

Last modified on August 22, 2026

Get started

Reference

Support

Reproduction template

Open a GitHub issue

​Reproduction template

Open a GitHub issue

Reproduction template