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

​

運作方式

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

​

設定檔功能

​

設定檔模式

• 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,
    },
  },
};

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

​

CLI 用法

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

​

生命週期說明

• Extension.js 會為每次執行建立暫存的受管理設定檔。
• Extension.js 會在多次執行間重複使用持久的受管理設定檔(dev)。
• Extension.js 會自動移除舊的受管理設定檔資料夾。可透過 EXTENSION_TMP_PROFILE_MAX_AGE_HOURS 控制最長保留時間。

​

最佳實務

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

​

後續步驟

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