CLI

parcel CLI は、Parcel を使用する最も一般的な方法です。 serve、watch、build の 3 つの異なるコマンドをサポートしています。

parcel [serve] <エントリポイント>

#

serve コマンドは開発サーバーを起動します。これは、ファイルを変更するとアプリを自動的に再構築し、ホットリロード をサポートします。 1 つ以上のファイルパスまたは glob を エントリポイント として受け入れます。 serve はデフォルトのコマンドなので、エントリポイントを parcel に直接渡すことによって使用することもできます。

parcel src/index.html

注記: 複数の HTML エントリポイントを指定していて、そのいずれも出力パスが /index.html でない場合、Parcel はどの HTML バンドルがインデックスかわからないため、開発サーバーは http://localhost:1234/ に 404 で応答します。

この場合、http://localhost:1234/a.html や http://localhost:1234/b.html など、ファイルを直接ロードしてください。

詳細は、開発 を参照してください。

parcel watch <エントリポイント>

#

watch コマンドは serve に似ていますが、開発サーバー (HMRサーバーのみ) を起動しません。ただし、変更を加えるとアプリを自動的に再構築し、ホットリロード をサポートします。ライブラリ、バックエンドを構築している場合、または独自の開発 (HTTP) サーバーを持っている場合は、watch を使用してください。エントリポイントの指定方法については、以下 を参照してください。

parcel watch src/index.html

parcel build <エントリポイント>

#

build コマンドは、1 回の produção ビルドを実行して終了します。 これにより、デフォルトで スコープホイスト やその他の produção 最適化が有効になります。エントリポイントの指定方法については、以下 を参照してください。

parcel build src/index.html

詳細は、本番環境 を参照してください。

エントリポイント

#

すべてのパッケージコマンドは、1 つ以上のエントリポイントを受け入れます。エントリポイントは、相対パスまたは絶対パス、あるいは glob で指定できます。 また、source フィールドを持つ package.json を含むディレクトリにすることもできます。 エントリポイントが完全に省略された場合、現在の作業ディレクトリの package.json の source フィールドが使用されます。 詳細は、ターゲットドキュメントの エントリポイント を参照してください。

注記: シェルによって解決されずに Parcel に直接渡されるように、glob は必ず単一引用符で囲んでください。 これにより、Parcel は再起動する必要なく、glob に一致する新しく作成されたファイルを自動的に取得できます。

# Single file
parcel src/index.html

# Multiple files
parcel src/a.html src/b.html

# Glob (quotes required)
parcel 'src/*.html'

# Directory with package.json#source
parcel packages/frontend

# Multiple packages with a glob
parcel 'packages/*'

# Current directory with package.json#source
parcel

パラメータ

#

これらのパラメータは、すべてのパッケージコマンドでサポートされています。

形式 説明
--target [名前] ビルドするターゲットを指定します。複数回指定できます。 ターゲット を参照してください。
--dist-dir <ディレクトリ> ターゲットで指定されていない場合に書き込む出力ディレクトリ。
package.json targets の distDir オプションのデフォルト値。
--public-url <URL> 絶対 URL のパスプレフィックス。
package.json targets の publicUrl オプションのデフォルト値。
--no-source-maps ソースマップを無効にします。
package.json targets の sourceMap オプションをオーバーライドします。
--config <パス> 使用する Parcel 設定を指定します。
ファイルパスまたはパッケージ名を指定できます。 デフォルトは @parcel/config-default です。 Parcel 設定 を参照してください。
--reporter <パッケージ名> .parcelrc で指定されているものに加えて、指定されたレポータープラグインを実行します。複数回指定できます。
--log-level (none/error/warn/info/verbose) ログレベルを設定します。
--cache-dir <パス> キャッシュディレクトリを設定します。 デフォルトは .parcel-cache です。 キャッシュ を参照してください。
--no-cache ファイルシステムキャッシュからの読み取りを無効にします。 キャッシュ を参照してください。
--profile ビルド中に CPU サンプリングプロファイルを実行します (フレームチャートを生成できます)。
--trace ビルド中に トレース を実行します。
-V, --version バージョン番号を出力します。

serve および watch 固有のパラメータ

#
形式 説明
-p, --port <ポート> 開発サーバーと HMR のポート (デフォルトのポートは process.env.PORT または 1234 です)。 開発サーバー を参照してください。
--host <ホスト> リッスンするホストを設定します。デフォルトはすべてのインターフェースでリッスンします。
--https 開発サーバーと HMR サーバーを HTTPS 経由で実行します。
--cert <パス> 使用する証明書のパス。 HTTPS を参照してください。
--key <パス> 使用する秘密鍵のパス。 HTTPS を参照してください。
--no-hmr ホットリロード を無効にします。
--hmr-port <ポート> HMR サーバーのポート (デフォルトは開発サーバーのポート)。 ホットリロード を参照してください。
--hmr-host <ホスト> HMR サーバーのホスト (デフォルトは開発サーバーのホスト)。 ホットリロード を参照してください。
--no-autoinstall 自動インストール を無効にします。
--watch-dir ルート監視ディレクトリを設定します。サブプロジェクトにロックファイルがあるモノレポに役立ちます。
--watch-for-stdin 標準入力が閉じられたら Parcel を停止します。

serve 固有のパラメータ

#
形式 説明
--open [ブラウザ] エントリをブラウザで自動的に開きます。 デフォルトはデフォルトのブラウザです。 開発サーバー を参照してください。
--lazy 開発サーバーによって要求されたバンドルのみをビルドします。 レイジーモード を参照してください。

build 固有のパラメータ

#
形式 説明
--no-optimize 縮小などの最適化を無効にします。
package.json targets の optimize オプションをオーバーライドします。 本番環境 を参照してください。
--no-scope-hoist スコープホイストを無効にします。
package.json targets の scopeHoist オプションをオーバーライドします。 スコープホイスト を参照してください。
--no-content-hash 出力ファイル名のコンテンツハッシュを無効にします。
バンドル名にはハッシュが含まれる場合がありますが、ビルドごとに変更されることはありません。 コンテンツハッシュ を参照してください。
--detailed-report [深さ] CLI レポートにバンドルごとに最大 10 個 (数は depth で設定可能) のアセットを表示します。 詳細レポート を参照してください。