debundle

Debundle

Dies ist ein Tool, das zum Auspacken von JavaScript -Bundles von Webpack und Browserify erstellt wurde.

---

? Hier werden Drachen! ?

Dies war ein Forschungsprojekt, das nicht mehr aufrechterhalten wird . Ich habe mir gebaut, um zu verstehen, wie JavaScript -Bündel gestürzt werden. Es arbeitet die meiste Zeit in einer Labrationsumgebung, scheitert jedoch häufig in JavaScript-Bündeln der realen Welt. Es ist eine Weile her, dass ich an diesem Projekt gearbeitet habe. Wenn Sie also auf Probleme stoßen, kann ich Ihnen möglicherweise nicht wirklich helfen.

---

Warum sollte ich meinen Code entsenden wollen?

Die Gründe variieren, aber dieses Tool wurde ursprünglich entwickelt, um mir bei einem Reverse Engineering -Projekt zu helfen. Unnötig zu erwähnen, dass das Sieben von Minimified -Bündeln versucht, herauszufinden, wie ein Dienst funktioniert, macht keinen Spaß und ist viel einfacher, wenn dieses Bundle in Dateien unterteilt ist und diese Dateien semantische Namen haben.

Installation

 npm i -g debundle

Läuft

$ debundle
Usage: debundle [input file] {OPTIONS}

Options:
   --input,  -i  Bundle to debundle
   --output, -o  Directory to debundle code into.
   --config, -c  Configuration file

$ curl https://raw.githubusercontent.com/1egoman/debundle/master/test_bundles/browserify/bundle.js > bundle.js
$ curl https://raw.githubusercontent.com/1egoman/debundle/master/test_bundles/browserify/debundle.config.json > debundle.config.json
$ cat debundle.config.json
{
  " type " : " browserify " ,
  " knownPaths " : {}
}
$ debundle -i bundle.js -o dist/ -c debundle.config.json
$ tree dist/
dist/
├── index.js
└── node_modules
    ├── number
    │   └── index.js
    └── uuid
        ├── index.js
        ├── lib
        │   ├── bytesToUuid.js
        │   └── rng.js
        ├── v1.js
        └── v4.js
4 directories, 7 files

Konfiguration

Einfache Konfiguration

 {
  "type": "browserify",
  "entryPoint": 1,
  "knownPaths": {}
}

(Ersetzen Sie die obige browserify durch ein einfaches Webpack -Bundle, um die obige Konfiguration durch webpack zu ersetzen.)

Eine Konfiguration kann eine Reihe von Flags haben - sie sind in docs.md dokumentiert.

FAQ

Ist das debundling verlustlos? Wenn ich meinen Code bündle, dann bekomme ich dann die gleiche Quelle, die ursprünglich gebündelt wurde?

Nein, gibt es ein Haufen Metadaten, die beim Bündeln verloren gehen:

• Alle benutzerdefinierten package.json -Einstellungen für jedes node_module und das Stammpaket.
• In einem Webpack -Bundle befinden sich die Namen der Module nicht im Bundle. Standardmäßig werden Debundling -Dateien erzeugt, die nach der Modul -ID (dh 1.js ) benannt sind, sofern nicht manuell überschrieben.
• Wenn Ihr Code abgebrochen wurde, werden die Ausgabedateien aus dem Debundling -Prozess ebenfalls abgebaut (dh ohne Whitespace, einzelne Buchstabenvariablen usw.). Es liegt an Ihnen, Quelle durch andere Tools auszuführen, damit es schöner aussieht.

Mein debundierter Code kann nicht ausgeführt werden!

• Stellen Sie sicher, dass Sie die richtige Datei als Einstiegspunkt verwenden, wenn Sie die richtige Datei verwenden oder mit dem Knoten ausgeführt werden.
• Lesen Sie alle Konfigurationsoptionen durch. Einige von ihnen haben Vorbehalte.
• Sie hätten in einen Randkoffer stoßen können, den ich noch nicht gesehen habe. Fühlen Sie sich frei, ein Problem zu eröffnen, wenn Sie glauben, dass dies der Fall ist.

Unterstützt dieses Tool Bündel, die von anderen Tools als Browserify und WebPack hergestellt wurden?

Nicht offiziell. Wenn ein Bundle jedoch das gleiche Typ -Modul -Layout für Browserify oder Webpack hat, kann es möglich sein, die Option "Moduleaste -Konfiguration" festzulegen, um auf den Speicherort der Module zu verweisen.

Beitragen

• Führen Sie nach dem Klonen des Projekts npm install aus - das sollte es sein.
• Debundler -Einstiegspunkt ist ./src/index.js (so leiten Sie es!)
• Eine Gruppe von Probenbündeln befindet sich in test_bundles/ . Ein Skript, test_bundles/run_test.sh kann den Debundler gegen ein bestimmtes Bündel ausführen und versuchen, ihn in dist/ zu entlarven. (CI wird im Rahmen von Tests alle Bündel in diesem Ordner debütieren.)
• Stellen Sie sicher, dass ein Beitrag die Tests bestehen: npm test

Rechtsnotiz

Einige Unternehmen geben in ihren Nutzungsbedingungen an, dass ihr Code nicht "umgekehrt konstruiert" werden kann. Das Debundling kann definitiv (je nachdem, wie Sie den Code verwenden) unter diesen Dach fallen. Verstehen Sie, was Sie tun, damit Sie keine Vereinbarungen brechen?