Mengganti halaman Chrome

Ekstensi dapat menggunakan halaman penggantian HTML untuk mengganti halaman yang biasanya disediakan Google Chrome. Ekstensi dapat berisi penggantian untuk salah satu halaman berikut, tetapi setiap ekstensi hanya dapat mengganti satu halaman:

Pengelola Bookmark

Halaman yang muncul saat pengguna memilih item menu Pengelola Bookmark dari menu Chrome atau, di Mac, item Pengelola Bookmark dari menu Bookmark. Anda juga dapat membuka halaman ini dengan memasukkan URL chrome://bookmarks.

Histori

Halaman yang muncul saat pengguna memilih item menu Histori dari menu Chrome atau, di Mac, item Tampilkan Histori Lengkap dari menu Histori. Anda juga dapat membuka halaman ini dengan memasukkan URL chrome://history.

Tab Baru

Halaman yang muncul saat pengguna membuat tab atau jendela baru. Anda juga dapat membuka halaman ini dengan memasukkan URL chrome://newtab.

Screenshot berikut menampilkan halaman Tab Baru default, lalu halaman Tab Baru kustom.

Untuk mencobanya, lihat contoh penggantian kami.

Perilaku jendela Samaran

Di jendela samaran, ekstensi tidak dapat mengganti halaman Tab Baru. Halaman lain masih berfungsi jika properti manifes samaran ditetapkan ke "spanning" (nilai default). Untuk mengetahui detail tentang cara menangani jendela Samaran, lihat Menyimpan data dan mode Samaran.

Manifes

Gunakan kode berikut untuk mendaftarkan halaman penggantian di manifes ekstensi:

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

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

Untuk PAGE_TO_OVERRIDE, ganti dengan salah satu dari yang berikut ini:

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

Praktik terbaik

• Buat halaman Anda cepat dan kecil.
  Pengguna mengharapkan halaman browser bawaan terbuka secara instan. Hindari melakukan hal-hal yang mungkin memerlukan waktu yang lama. Secara khusus, hindari mengakses resource database secara sinkron. Saat membuat permintaan jaringan, pilih fetch() daripada XMLHttpRequest().

• Untuk menghindari kebingungan pengguna, beri judul pada halaman Anda.
  Tanpa judul, judul halaman akan ditetapkan secara default ke URL. Tentukan judul menggunakan tag <title> di file HTML Anda.

• Ingat bahwa tab baru memberikan fokus keyboard ke kolom URL terlebih dahulu.
  Jangan mengandalkan fokus keyboard yang secara default beralih ke bagian lain halaman.

• Buat halaman tab baru Anda sendiri.
  Hindari membuat halaman tab baru yang mungkin membingungkan pengguna dengan halaman tab baru default Chrome.

Contoh

Lihat contoh penggantian.