debundle

Debundle

これは、webpackとbrowserifyによって腐ったJavaScriptバンドルを開梱するために構築されたツールです。

---

？ここにドラゴンになります！ ？

これは、もはや維持されていない研究プロジェクトでした。 JavaScriptのバンドルがどのようにstrutされているかを理解するのに役立つように構築しました。ほとんどの場合、唇の環境で動作しますが、多くの場合、実際のJavaScriptバンドルで失敗します。私がこのプロジェクトに取り組んでからしばらく経ちましたので、問題が発生した場合、それほどあなたをあまり助けることができないかもしれません。

---

なぜ私は自分のコードを非難したいのですか？

理由はさまざまですが、このツールはもともとリバースエンジニアリングプロジェクトを支援するために開発されました。言うまでもなく、マニーム化されたバンドルをふるいにかけて、サービスがどのように機能するかを試してみて、バンドルがファイルに分割され、それらのファイルがセマンティック名を持っている場合、はるかに簡単になります。

インストール

 npm i -g debundle

ランニング

$ 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

構成

単純な構成

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

（シンプルなWebpackバンドルを非難するには、上記の構成をwebpackでbrowserifyすること）を交換してください）

構成には多くのフラグを持つことができます - それらはdocs.mdで文書化されています。

よくある質問

デバンドロスレスはありますか？つまり、コードをバンドルしてから暴露した場合、もともとバンドルされていたのと同じソースが得られますか？

いいえ。束ねたときに失われるメタデータの束があります。

• 各node_moduleとルートパッケージのカスタムpackage.json 。
• Webpackバンドルでは、モジュールの名前はバンドルにありません。デフォルトでは、Debundlingは、手動でオーバーライドされない限り、モジュールID（IE、 1.js ）にちなんで名付けられたファイルを作成します。
• コードが縮小された場合、デバンドリングプロセスからの出力ファイルも削除されます（つまり、白人、単一の文字変数など）。他のツールを使用してソースを実行して見栄えを良くするのはあなた次第です。

私のデバンドされたコードは実行できません！

• 正しいファイルをエントリポイントとして使用していることをノードでbund弾または実行するときのいずれかを確認してください。
• すべての構成オプションを読み取ります。それらのいくつかは警告を持っています。
• あなたは私がまだ見ていないエッジケースに出くわすことができたかもしれません。あなたがそうだと思われる場合は、問題を自由に開いてください。

このツールは、browserifyやwebpack以外のツールによって作成されたバンドルをサポートしていますか？

公式ではありません。ただし、Bundleがbrowserifyまたはwebpackと同じタイプモジュールレイアウトを共有している場合、モジュールの位置を指すようにモジュールの構成オプションを設定することができる場合があります。

貢献

• プロジェクトをクローニングした後、 npm installを実行します - それはそれであるはずです。
• Debundlerエントリポイントは./src/index.jsです（それがあなたがそれを実行する方法です！）
• サンプルバンドルの束はtest_bundles/にあります。スクリプト、 test_bundles/run_test.sh特定のバンドルに対してデブンドラーを実行して、それをdist/にdebundすることを試みることができます。 （CIは、実行中のテストの一環として、そのフォルダー内のすべてのバンドルを非難します。）
• 貢献がテストに合格していることを確認してください： npm test

法的メモ

一部の企業は、サービスの利用規約で、コードを「リバースエンジニアリング」できないことを指定しています。デバンドリングは、（コードの使用方法によっては）間違いなくその傘下にあります。あなたが何をしているのか理解しているので、あなたは契約を破らないでしょうか？