用於隔離開發執行的瀏覽器設定檔管理

​

運作方式

1. 當 profile: false 或 EXTENSION_USE_SYSTEM_PROFILE=true 時使用系統設定檔模式
2. 明確指定的 profile 路徑(若有提供)
3. 受管理設定檔模式(預設)
   • 預設為暫存(短暫)模式
   • 當 persistProfile: true 或 keepProfileChanges: true 時改為持久模式

​

--profile 的值如何被讀取

• --profile=false(或設定檔中的 profile: false)代表使用瀏覽器自己的預設設定檔。
• --profile=true 代表受管理的預設值,等同於不設定這個選項。
• 其他任何字串都會被當成明確指定的設定檔路徑。

​

Firefox 與其他 Gecko 瀏覽器上的系統設定檔模式

Firefox can't load the add-on in its own profile, so it was not launched.
SET BY --profile=false
Remote debugging is off in a browser's own profile, and the add-on can only be installed over it.
To fix, drop --profile=false, then let Extension.js manage the profile or pass --profile=<path> to use a profile of your own.

• 拿掉 --profile=false(以及 profile: false 或 EXTENSION_USE_SYSTEM_PROFILE),讓 Extension.js 管理設定檔並安裝附加元件。加上 persistProfile: true 可在多次執行間保留登入與狀態,也可以用 copyFromProfile 從既有設定檔為受管理設定檔建立初始內容。
• 傳入 --profile=<path>,以你自己的設定檔目錄啟動。Extension.js 會把附加元件安裝進去。

​

設定檔功能

​

以 copyFromProfile 建立初始內容

​

設定檔模式

• dist/extension-js/profiles/<browser>-profile/<...>

• dist/extension-js/profiles/<browser>-profile/dev

​

在 extension.config.* 中設定

export default {
  browser: {
    chrome: {
      // Use your own profile folder:
      profile: "path/to/custom/profile",
    },
    firefox: {
      // Keep a stable managed profile for repeated sessions:
      persistProfile: true,
    },
    edge: {
      // Keep changes across runs and seed once from an existing profile:
      keepProfileChanges: true,
      copyFromProfile: "/path/to/existing/profile",
    },
  },
};

export default {
  commands: {
    dev: {
      persistProfile: true,
    },
  },
};

​

CLI 用法

extension dev --browser=chrome --profile=/path/to/custom/profile

​

生命週期說明

• Extension.js 會為每次執行建立暫存的受管理設定檔。
• Extension.js 會在多次執行間重複使用持久的受管理設定檔(dev)。
• 每個暫存設定檔都帶有一個 .extension-js-managed-profile 標記檔。瀏覽器結束時,Extension.js 只會移除帶有該標記的目錄,因此被保留的設定檔與明確指定的設定檔永遠不會被回收。
• Extension.js 也會在下次啟動時清掃過期的帶標記設定檔。可透過 EXTENSION_TMP_PROFILE_MAX_AGE_HOURS 控制最長保留時間(預設 12 小時)。
• 每次啟動 Firefox 時,Extension.js 都會刪除該設定檔的 startupCache 目錄。否則被釘選或持久化的設定檔可能在整次 dev 重新啟動後仍提供過期的擴充功能程式碼。

​

被鎖定的 Chromium 設定檔

​

隱私

​

最佳實務

• 以受管理的暫存設定檔做基線測試:減少隱藏狀態與難以重現的問題。
• 以 persistProfile 進行長時間除錯:在多次執行間保留登入/工作階段/開發者工具狀態。
• 每個瀏覽器家族使用各自的自訂設定檔:避免跨瀏覽器互相污染。
• 有意識地使用系統設定檔模式:適合在 Chromium 家族瀏覽器上重現問題,但隔離程度不如受管理設定檔。Extension.js 會拒絕在這種模式下啟動 Gecko 瀏覽器。

​

後續步驟

• 進一步了解 瀏覽器偏好設定。
• 進一步了解 瀏覽器旗標。