Haxe-JavaScript code minifier & obfuscator
Haxe
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
src
.gitattributes
.gitignore
README.md

README.md

HaxMin

JavaScript obfuscator, powered by Haxe, intended for use with Haxe-generated JavaScript code. Compatible with Reflect. May also work with non-Haxe code (as long as accessors are prefixed accordingly).

Usage

Pretty straight-forward:

neko Haxmin.n filePath

Or also specify the destination file:

neko Haxmin.n inPath outPath

Or add an extra file with "whitelisted" identifier names:

neko Haxmin.n inPath outPath whiteListPath1 whiteListPath2 ...

For easier usage you can also pass an "array" with whitelisted identifiers:

neko Haxmin.n inPath outPath [name1,name2,...]

A precompiled Haxmin.n can be found in bin/. Binary file of Neko is placed as well, just in case. "default.txt" contains "default" whitelisted names and contains identifiers from HTML5 API accessible from Haxe (generated from js.html.*). Format for custom whitelist files is also straight-forward: one identifier name per line. Lines are to be terminated with char 10.

Known issues

  • Program may accidentally "obfuscate" strings that have contents same as variable names. This happens because it's not possible to easily recognize whether the value is going to be used with Reflect or not. You can fix this by modifying the strings or by creating a whitelist file with them.
  • "Composing" strings ("my" + "Field" + "1") may cause them to not work with Reflect after obfuscation. Doing so is not a good practice either. Think about it.

Future

The following features are planned to be added to program in future:

  • Balance get_/set_ prefix obfuscation to warrant smallest filesizes.
  • Possibly add micro-optimizations to reduce file size even further.
  • Possibly include "legal" unicode characters in renamed identifiers while keeping their lengths in mind.

Licence

Currently HaxMin itself is licenced under Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported licence. Obfuscated code of yours remains in your ownership, obviously :)