# vite-plugin-bundle-obfuscator JavaScript `obfuscator` plugin for `Vite` environments [](https://github.com/vitejs/awesome-vite) [![][npm-release-shield]][npm-release-link] [![][npm-downloads-shield]][npm-release-link] [![][github-releasedate-shield]][github-releasedate-link] [![][github-license-shield]][github-license-link] [Changelog](./CHANGELOG.md) · [Report Bug][github-issues-link] · [Request Feature][github-pr-link]

English | 中文


⭐️ Features

• [x] ⚡ Supports JavaScript obfuscation in Vite projects.
• [x] ⚙️ Customizable obfuscator options to fit your needs.
• [x] 🛡️ Auto-excludes node_modules.
• [x] 🚀 Multi-threading support for better performfance.
• [ ] 📦 ？Support the node_modules split chunk.

⚠️ Notice

• If the obfuscation option stringArray is true.
  • Your results may lose some bundles (in __vite__mapDeps array).
  • I'm looking for an accurate case.

📦 Installation

# Using npm
npm install vite-plugin-bundle-obfuscator -D

# Using pnpm
pnpm add vite-plugin-bundle-obfuscator -D

# Using yarn
yarn add vite-plugin-bundle-obfuscator -D

👨‍💻 Usage

1. Install the plugin using your preferred package manager.
2. Register the plugin in vite.config.js
3. Customize the obfuscator configuration or use the default options.

Example:

import vitePluginBundleObfuscator from 'vite-plugin-bundle-obfuscator';

const defaultObfuscatorConfig = {
  excludes: [],
  enable: true,
  log: true,
  autoExcludeNodeModules: false,
  threadPool: false,
  options: {
    compact: true,
    controlFlowFlattening: true,
    controlFlowFlatteningThreshold: 1,
    deadCodeInjection: false,
    debugProtection: false,
    debugProtectionInterval: 0,
    disableConsoleOutput: false,
    identifierNamesGenerator: 'hexadecimal',
    log: false,
    numbersToExpressions: false,
    renameGlobals: false,
    selfDefending: true,
    simplify: true,
    splitStrings: false,
    stringArray: false,
    stringArrayCallsTransform: false,
    stringArrayCallsTransformThreshold: 0.5,
    stringArrayEncoding: [],
    stringArrayIndexShift: true,
    stringArrayRotate: true,
    stringArrayShuffle: true,
    stringArrayWrappersCount: 1,
    stringArrayWrappersChainedCalls: true,
    stringArrayWrappersParametersMaxCount: 2,
    stringArrayWrappersType: 'variable',
    stringArrayThreshold: 0.75,
    unicodeEscapeSequence: false,
  }
};

export default {
  plugins: [
    // vitePluginBundleObfuscator()
    vitePluginBundleObfuscator(defaultObfuscatorConfig)
  ]
};

🛠️ Options

📄 License

MIT License Copyright (c) 2024-present, Zoffy