preview 不會編譯你的專案,它會載入既有的未打包擴充功能根目錄,並執行瀏覽器啟動流程。
何時使用 preview
- 不重新建置,直接執行既有的建置輸出。
- 快速比較不同瀏覽器目標下的打包後行為。
- 除錯與正式版產物有關、而非開發/監看模式的執行階段問題。
Preview 指令功能
preview只執行,不建置。當dist/<browser>輸出存在時優先使用。你也可以指向其他已包含manifest.json的未打包擴充功能資料夾。
用法
preview 如何選擇要執行的內容
preview 會依序檢查這些位置:
- 所選瀏覽器目標的
dist/<browser>。 - 你提供的專案路徑或目前工作資料夾。
manifest.json 的未打包擴充功能。是否在同一個指令中執行過 build 並不重要。
引數與旗標
自動化中介資料
preview 會把就緒中介資料寫入:
dist/extension-js/<browser>/ready.json
--no-browser 流程,它能提供確定性的指令狀態:
starting:指令初始化中ready:僅執行的驗證完成error:缺少必要輸出或啟動失敗runId與startedAt:讓腳本/代理可關聯特定工作階段
preview 沒有 --wait 閘道旗標。要把 preview 自動化,直接讀取 ready.json。
記錄旗標
共用全域選項
也支援 全域旗標。範例
預覽本地擴充功能
在 Edge 與 Chrome 中預覽
預覽但不啟動瀏覽器
行為說明
preview只執行,從不編譯專案。preview優先使用既有的建置輸出(dist/<browser>),但可退回到其他未打包擴充功能根目錄。preview不會執行監看模式或 Hot Module Replacement (HMR)。- 腳本/代理請依賴
ready.json,避免解析終端機輸出。
最佳實務
- 測試全新的正式版產物時,先執行
build再preview。 - 當你的未打包擴充功能不在預設的專案輸出位置時,請傳入專案路徑引數。
- 使用
--browser在打包前跨目標驗證行為。
後續步驟
- 用
start在一個步驟完成建置與啟動。 - 用
build產生正式版產物。 - 在
extension.config.js中集中設定共用預設值。 - 在 環境變數 中了解設定的環境檔載入行為。