NPM パッケージの利用
視聴する
Using the Obfuscator.io API: API Keys, npm Package, CLI and Custom Presets
このパッケージはビルドを obfuscator.io の API に送信するため、apiToken(CLI では --pro-api-token)として渡す API キー(Pro、Team、Business)が必要です。キーやチームサービスキーの作成、およびそれらをブラウザーのコードに含めない方法については、API リファレンスで説明しています。
npm
production.json
Node.js (.mjs)
CLI
クォータ
javascript-obfuscator 5.9.0 以降では、getProQuota でプランの残りの使用量を取得できます。これにより、ビルドを途中で失敗させるのではなく、開始前にファイルが残量に収まるかどうかを確認できます。ビルドはソースのサイズをバイト単位(UTF-8)で計上し、計上量は最低でも minBytesPerBuild になります。出力のサイズは計上されません。上限に達したためにビルドが拒否された場合、スローされる ApiError の code は dailyLimit または monthlyLimit になり、その期間の resetsAt がリセットされる日時を示します。各フィールドについては API リファレンスで説明しています。
クォータを確認する Node.js (.mjs)
カスタムプリセット
設定ファイルではなくダッシュボードで設定を管理できます。現在のオプションをカスタムプリセットとして保存し、保存ダイアログで API エイリアスを付けて、optionsPreset にそのエイリアスを指定します。javascript-obfuscator 5.8.0 以降は難読化の前にプリセットを取得するため、ダッシュボードでプリセットを変更すれば次のビルドに反映され、リポジトリへのコミットは不要です。プリセットのオプションがベースになり、設定にあるその他のオプションがそれを上書きします。組み込みプリセットのマージと同じ順序です。チームサービスキーはチームオーナーのプリセットを解決します。メンバーの API キーは、そのメンバー自身のプリセットと、オーナーがチームに共有したプリセットを解決します。
プリセットを使う Node.js (.mjs)
プリセットを使う CLI
--config を使うビルドでは、production.json に "optionsPreset": "production" と書いても同じです。vm-default のような組み込み名がエイリアスとして検索されることはありません。持っていないエイリアスはソースを送信する前に HTTP 404 で失敗し、Pro 機能を有効にしていないカスタムプリセットはそのオプションでローカルに難読化されます。
REST でプリセットを取得する
直接の REST 連携では、難読化リクエストの optionsPreset に同じエイリアスを指定でき、サーバーが同じ方法で解決します。難読化せずにプリセットのオプションを読み取るには、プリセットのエンドポイントを使用してください。どちらも API リファレンスに記載しています。javascript-obfuscator パッケージは実行ごとに 1 回プリセットを取得し、そのリクエストは難読化リクエストと同じユーザーごとのレート制限に含まれます。
レート制限と大きなファイルのアップロード時の動作は API リファレンスで説明しており、ご利用のプランの制限はダッシュボードに表示されます。Team プランと Business プランでは、パッケージが大きなソースに対して自動的に一時アップロードへ切り替えます。
