覆寫 Chrome 網頁

擴充功能可以使用 HTML 覆寫網頁取代 Google Chrome 平常提供的網頁。擴充功能可覆寫下列任一網頁，但每個擴充功能只能覆寫一個網頁：

書籤管理員

使用者從 Chrome 選單選擇「書籤管理員」選單項目時會顯示的網頁，如果是 Mac，則會顯示「書籤管理員」選單中的「書籤管理員」項目。您也可以輸入 chrome://書籤 s 來前往這個頁面。

記錄

使用者從 Chrome 選單選擇「歷史記錄」選單項目時顯示的頁面，如果使用 Mac，則會顯示「歷史記錄」選單中的「顯示完整歷史記錄」項目。您也可以輸入 chrome://history 網址前往這個頁面。

新分頁

使用者建立新分頁或視窗時顯示的頁面。您也可以輸入 chrome://newtab 網址前往這個頁面。

以下螢幕截圖顯示預設的「新分頁」和自訂「新分頁」頁面。

預設的新分頁。

自訂新分頁。

如要試用這項功能，請參閱覆寫範例。

無痕式視窗行為

在無痕式視窗中，擴充功能無法覆寫「新分頁」頁面。如果無痕模式資訊清單屬性設為「spanning」(預設值)，其他頁面仍可正常運作。如要進一步瞭解如何處理無痕式視窗，請參閱儲存資料和無痕模式。

資訊清單

請使用以下程式碼，在擴充功能資訊清單中註冊覆寫頁面：

{
  "manifest_version": 3,
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "PAGE_TO_OVERRIDE": "myPage.html"
  },
  ...
}

如果是 PAGE_TO_OVERRIDE，則可替換為下列任一值：

• "bookmarks"
• "history"
• "newtab"

最佳做法

• 打造簡短的網頁。
  使用者希望內建瀏覽器頁面能立即開啟。避免執行可能需要較長時間的操作。具體而言，請避免同步存取資料庫資源。提出網路要求時，請優先使用 fetch()，而非 XMLHttpRequest()。

• 為了避免造成使用者混淆，請為網頁命名。
  如果沒有標題，網頁標題就會預設為網址。在 HTML 檔案中使用 <title> 標記指定標題。

• 提醒你，新分頁會先將鍵盤焦點移至網址列。
  不要將鍵盤焦點預設為在網頁的其他部分顯示。

• 打造個人專屬的新分頁。
  避免建立新的分頁頁面，以免使用者混淆 Chrome 的預設新分頁。

範例

請參閱「覆寫範例」。