chrome.webNavigation

Deskripsi

Gunakan chrome.webNavigation API untuk menerima notifikasi tentang status permintaan navigasi yang sedang beroperasi.

Izin

webNavigation

Semua metode dan peristiwa chrome.webNavigation mengharuskan Anda mendeklarasikan izin "webNavigation" di manifes ekstensi. Contoh:

{
  "name": "My extension",
  ...
  "permissions": [
    "webNavigation"
  ],
  ...
}

Konsep dan penggunaan

Urutan acara

Untuk navigasi yang berhasil diselesaikan, peristiwa akan diaktifkan dalam urutan berikut:

onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted

Setiap error yang terjadi selama proses akan menghasilkan peristiwa onErrorOccurred. Untuk tujuan navigasi, tidak ada peristiwa lebih lanjut yang diaktifkan setelah onErrorOccurred.

Jika frame navigasi berisi subframe, onCommitted-nya akan diaktifkan sebelum elemen turunannya onBeforeNavigate; sedangkan onCompleted diaktifkan setelah semua onCompleted turunannya.

Jika fragmen referensi frame diubah, peristiwa onReferenceFragmentUpdated akan diaktifkan. Ini dapat diaktifkan kapan saja setelah onDOMContentLoaded, bahkan setelah onCompleted.

Jika API histori digunakan untuk mengubah status frame (mis. menggunakan history.pushState(), Peristiwa onHistoryStateUpdated diaktifkan. Peristiwa ini dapat diaktifkan kapan saja setelah onDOMContentLoaded.

Jika navigasi memulihkan halaman dari Back Forward Cache, peristiwa onDOMContentLoaded tidak akan diaktifkan. Peristiwa tidak diaktifkan karena konten telah selesai dimuat saat halaman pertama kali dikunjungi.

Jika navigasi dipicu menggunakan Chrome Instan atau Halaman Instan, banner yang dimuat sepenuhnya ditukar ke tab saat ini. Dalam hal ini, peristiwa onTabReplaced diaktifkan.

Hubungan dengan peristiwa webRequest

Tidak ada pengurutan yang ditentukan antara peristiwa webRequest API dan peristiwa webNavigation API. Ada kemungkinan bahwa peristiwa webRequest masih diterima untuk frame yang sudah memulai navigasi baru, atau navigasi hanya dilanjutkan setelah sumber daya jaringan sudah termuat sepenuhnya.

Secara umum, peristiwa webNavigation terkait erat dengan status navigasi yang ditampilkan di UI, sedangkan peristiwa webRequest sesuai dengan status tumpukan jaringan yang tidak jelas bagi pengguna.

ID tab

Tidak semua tab navigasi sesuai dengan tab sebenarnya di UI Chrome, misalnya tab yang dipra-render. Tab tersebut tidak dapat diakses menggunakan tab API dan Anda juga tidak dapat meminta informasi tentang mereka dengan memanggil webNavigation.getFrame() atau webNavigation.getAllFrames(). Setelah tab tersebut ditukar, peristiwa onTabReplaced akan diaktifkan dan dapat diakses melalui API ini.

Stempel waktu

Penting untuk diketahui bahwa beberapa keanehan teknis dalam penanganan OS Chrome yang berbeda dapat menyebabkan jam terdistorsi antara browser itu sendiri dan proses ekstensi. Bahwa berarti bahwa properti timeStamp dari properti timeStamp peristiwa WebNavigation hanya dijamin konsisten secara internal. Membandingkan satu peristiwa dengan acara lain akan memberi Anda offset yang benar di antara keduanya, tetapi membandingkannya dengan waktu saat ini dalam ekstensi (menggunakan (new Date()).getTime(), misalnya) dapat memberikan hasil yang tidak diharapkan.

ID Frame

Frame dalam tab dapat diidentifikasi melalui ID frame. ID {i>frame<i} dari {i>frame<i} utama selalu 0, itu ID frame turunan adalah bilangan positif. Setelah dokumen dibuat dalam suatu {i>frame<i}, ID {i>frame<i}-nya tetap konstan selama masa aktif dokumen. Mulai Chrome 49, ID ini juga konstan untuk masa aktif {i>frame<i} (di beberapa navigasi).

Karena sifat Chrome yang multiproses, tab mungkin menggunakan proses yang berbeda untuk merender sumber dan tujuan laman web. Oleh karena itu, jika navigasi berlangsung dalam proses baru, Anda mungkin menerima peristiwa dari halaman baru dan lama hingga navigasi baru di-commit (yaitu Peristiwa onCommitted dikirim untuk frame utama baru). Dengan kata lain, adalah mungkin untuk memiliki lebih banyak dari satu urutan peristiwa webNavigation yang tertunda dengan frameId yang sama. Urutan dapat berupa dibedakan berdasarkan kunci processId.

Perhatikan juga bahwa selama pemuatan sementara, proses mungkin diganti beberapa kali. Hal ini sering terjadi ketika beban dialihkan ke situs lain. Dalam hal ini, Anda akan menerima Peristiwa onBeforeNavigate dan onErrorOccurred, hingga Anda menerima peristiwa onCommitted terakhir.

Konsep lain yang bermasalah dengan ekstensi adalah siklus proses dari {i>frame<i}. Frame menghosting dokumen (yang terkait dengan URL yang di-commit). Dokumen dapat berubah (misalnya dengan menavigasi), tetapi frameId tidak, dan karenanya sulit mengaitkan sesuatu yang terjadi dalam dokumen tertentu dengan cukup frameIds. Kami memperkenalkan konsep documentId yang merupakan pengidentifikasi unik untuk setiap dokumen. Jika {i>frame<i} dinavigasi dan membuka dokumen baru yang pengenalnya akan berubah. Bidang ini berguna untuk menentukan saat halaman mengubah status siklus prosesnya (antara pra-rendering/aktif/di-cache) karena tetap sama.

Jenis dan penentu transisi

Peristiwa webNavigation onCommitted memiliki transitionType dan transitionQualifiers saat ini. Jenis transisi sama seperti yang digunakan di history API yang menjelaskan cara membuka URL tertentu. Selain itu, beberapa penentu transisi dapat kembali yang menentukan navigasi lebih lanjut.

Penentu transisi berikut ada:

Penentu transisi	Deskripsi
"client_redirect"	Satu atau beberapa pengalihan yang disebabkan oleh tag JavaScript atau refresh meta di halaman terjadi selama navigasi.
"server_redirect"	Satu atau beberapa pengalihan yang disebabkan oleh header HTTP yang dikirim dari server terjadi selama navigasi.
"forward_back"	Pengguna menggunakan tombol Maju atau Kembali untuk memulai navigasi.
"from_address_bar"	Pengguna memulai navigasi dari kolom URL (disebut Omnibox).

Contoh

Untuk mencoba API ini, instal contoh webNavigation API dari chrome-extension-samples repositori resource.

Jenis

TransitionQualifier

Chrome 44 dan yang lebih baru

Enum

"client_redirect"

"server_redirect"

"forward_back"

&quot;from_address_bar&quot;

TransitionType

Chrome 44 dan yang lebih baru

Penyebab navigasi. Jenis transisi yang sama seperti yang ditentukan dalam API histori digunakan. Ini adalah jenis transisi yang sama seperti yang didefinisikan dalam history API kecuali dengan "start_page" sebagai pengganti "auto_toplevel" (untuk kompatibilitas mundur).

Enum

"link"

&quot;typed&quot;

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"dibuat"

&quot;start_page&quot;

"form_submit"

"muat ulang"

"kata kunci"

"keyword_generated"

Metode

getAllFrames()

Janji

chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
)

Mengambil informasi tentang semua frame dari tab tertentu.

Parameter

• detail

  objek

  Informasi tentang tab tempat semua frame diambil.

  • tabId

    angka

    ID tab.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (details?: object[]) => void

  • detail

    object[] opsional

    Daftar frame di tab yang diberikan, null jika ID tab yang ditentukan tidak valid.

    • documentId

      string

      Chrome 106 dan yang lebih baru

      UUID dokumen yang dimuat.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • errorOccurred

      boolean

      Benar jika navigasi terakhir dalam frame ini terganggu oleh error, yaitu peristiwa onErrorOccurred diaktifkan.

    • frameId

      angka

      ID frame. 0 menunjukkan bahwa ini adalah {i>frame<i} utama; nilai positif menunjukkan ID subframe.

    • frameType

      FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      ID frame induk, atau -1 jika ini adalah frame utama.

    • processId

      angka

      ID proses yang menjalankan perender untuk frame ini.

    • url

      string

      URL yang saat ini terkait dengan frame ini.

Hasil

• Promise&lt;object[] | tidak terdefinisi>

  Chrome 93 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getFrame()

Janji

chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
)

Mengambil informasi tentang frame yang ditentukan. Bingkai mengacu pada <iframe> atau <frame> laman web dan diidentifikasi dengan ID tab dan ID {i>frame<i}.

Parameter

• detail

  objek

  Informasi tentang frame yang informasinya akan diambil.

  • documentId

    string opsional

    Chrome 106 dan yang lebih baru

    UUID dokumen. Jika frameId dan/atau tabId disediakan, keduanya akan divalidasi agar cocok dengan dokumen yang ditemukan berdasarkan ID dokumen yang diberikan.

  • frameId

    angka opsional

    ID frame di tab tertentu.

  • processId

    angka opsional

    Tidak digunakan lagi sejak Chrome 49

    Frame kini diidentifikasi secara unik berdasarkan ID tab dan ID frame; ID proses tidak lagi diperlukan sehingga diabaikan.

    ID proses yang menjalankan perender untuk tab ini.

  • tabId

    angka opsional

    ID tab tempat frame berada.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (details?: object) => void

  • detail

    objek opsional

    Informasi tentang frame yang diminta, null jika ID frame dan/atau ID tab yang ditentukan tidak valid.

    • documentId

      string

      Chrome 106 dan yang lebih baru

      UUID dokumen yang dimuat.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • errorOccurred

      boolean

      Benar jika navigasi terakhir dalam frame ini terganggu oleh error, yaitu peristiwa onErrorOccurred diaktifkan.

    • frameType

      FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      ID frame induk, atau -1 jika ini adalah frame utama.

    • url

      string

      URL yang saat ini terkait dengan frame ini, jika frame yang diidentifikasi oleh frameId ada di satu titik di tab yang ditentukan. Fakta bahwa URL dikaitkan dengan frameId tertentu tidak berarti bahwa frame yang terkait masih ada.

Hasil

• Promise&lt;object | tidak terdefinisi>

  Chrome 93 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

Acara

onBeforeNavigate

chrome.webNavigation.onBeforeNavigate.addListener(
  callback: function,
  filters?: object,
)

Diaktifkan saat navigasi akan segera dilakukan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • frameId

      angka

      0 menunjukkan navigasi yang terjadi di jendela konten tab; nilai positif menunjukkan navigasi dalam subframe. ID frame bersifat unik untuk tab dan proses tertentu.

    • frameType

      extensionTypes.FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      ID frame induk, atau -1 jika ini adalah frame utama.

    • processId

      angka

      Tidak digunakan lagi sejak Chrome 50

      processId tidak lagi ditetapkan untuk peristiwa ini, karena proses yang akan merender dokumen yang dihasilkan tidak diketahui hingga onCommit.

      Nilai -1.

    • tabId

      angka

      ID tab tempat navigasi akan terjadi.

    • timeStamp

      angka

      Waktu saat browser akan memulai navigasi, dalam milidetik sejak epoch.

    • url

      string

• filter

  objek opsional

  • url

    events.UrlFilter[]

    Kondisi yang harus dipenuhi oleh URL yang dibuka. 'Skema' dan 'port' kolom UrlFilter diabaikan untuk peristiwa ini.

onCommitted

chrome.webNavigation.onCommitted.addListener(
  callback: function,
  filters?: object,
)

Diaktifkan saat navigasi di-commit. Dokumen (dan resource yang dirujuk, seperti gambar dan subframe) mungkin masih didownload, tetapi setidaknya sebagian dokumen telah diterima dari server dan browser memutuskan untuk beralih ke dokumen baru.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • documentId

      string

      Chrome 106 dan yang lebih baru

      UUID dokumen yang dimuat.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • frameId

      angka

      0 menunjukkan navigasi yang terjadi di jendela konten tab; nilai positif menunjukkan navigasi dalam subframe. ID frame bersifat unik dalam satu tab.

    • frameType

      extensionTypes.FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      Chrome 74 dan yang lebih baru

      ID frame induk, atau -1 jika ini adalah frame utama.

    • processId

      angka

      ID proses yang menjalankan perender untuk frame ini.

    • tabId

      angka

      ID tab tempat terjadinya navigasi.

    • timeStamp

      angka

      Waktu saat navigasi di-commit, dalam milidetik sejak epoch.

    • transitionQualifiers

      TransitionQualifier[]

      Daftar penentu transisi.

    • transitionType

      TransitionType

      Penyebab navigasi.

    • url

      string

• filter

  objek opsional

  • url

    events.UrlFilter[]

    Kondisi yang harus dipenuhi oleh URL yang dibuka. 'Skema' dan 'port' kolom UrlFilter diabaikan untuk peristiwa ini.

onCompleted

chrome.webNavigation.onCompleted.addListener(
  callback: function,
  filters?: object,
)

Diaktifkan saat dokumen, termasuk resource yang dirujuknya, dimuat dan diinisialisasi sepenuhnya.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • documentId

      string

      Chrome 106 dan yang lebih baru

      UUID dokumen yang dimuat.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • frameId

      angka

      0 menunjukkan navigasi yang terjadi di jendela konten tab; nilai positif menunjukkan navigasi dalam subframe. ID frame bersifat unik dalam satu tab.

    • frameType

      extensionTypes.FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      Chrome 74 dan yang lebih baru

      ID frame induk, atau -1 jika ini adalah frame utama.

    • processId

      angka

      ID proses yang menjalankan perender untuk frame ini.

    • tabId

      angka

      ID tab tempat terjadinya navigasi.

    • timeStamp

      angka

      Waktu saat dokumen selesai dimuat, dalam milidetik sejak epoch.

    • url

      string

• filter

  objek opsional

  • url

    events.UrlFilter[]

    Kondisi yang harus dipenuhi oleh URL yang dibuka. 'Skema' dan 'port' kolom UrlFilter diabaikan untuk peristiwa ini.

onCreatedNavigationTarget

chrome.webNavigation.onCreatedNavigationTarget.addListener(
  callback: function,
  filters?: object,
)

Diaktifkan saat jendela baru, atau tab baru di jendela yang ada, dibuat untuk menghosting navigasi.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • sourceFrameId

      angka

      ID frame dengan sourceTabId tempat navigasi dipicu. 0 menunjukkan {i>frame<i} utama.

    • sourceProcessId

      angka

      ID proses yang menjalankan perender untuk frame sumber.

    • sourceTabId

      angka

      ID tab tempat navigasi dipicu.

    • tabId

      angka

      ID tab tempat URL dibuka

    • timeStamp

      angka

      Waktu saat browser akan membuat tampilan baru, dalam milidetik sejak epoch.

    • url

      string

      URL yang akan dibuka di jendela baru.

• filter

  objek opsional

  • url

    events.UrlFilter[]

    Kondisi yang harus dipenuhi oleh URL yang dibuka. 'Skema' dan 'port' kolom UrlFilter diabaikan untuk peristiwa ini.

onDOMContentLoaded

chrome.webNavigation.onDOMContentLoaded.addListener(
  callback: function,
  filters?: object,
)

Diaktifkan saat DOM halaman dibuat sepenuhnya, tetapi resource yang direferensikan mungkin tidak selesai dimuat.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • documentId

      string

      Chrome 106 dan yang lebih baru

      UUID dokumen yang dimuat.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • frameId

      angka

      0 menunjukkan navigasi yang terjadi di jendela konten tab; nilai positif menunjukkan navigasi dalam subframe. ID frame bersifat unik dalam satu tab.

    • frameType

      extensionTypes.FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      Chrome 74 dan yang lebih baru

      ID frame induk, atau -1 jika ini adalah frame utama.

    • processId

      angka

      ID proses yang menjalankan perender untuk frame ini.

    • tabId

      angka

      ID tab tempat terjadinya navigasi.

    • timeStamp

      angka

      Waktu saat DOM halaman dibuat sepenuhnya, dalam milidetik sejak epoch.

    • url

      string

• filter

  objek opsional

  • url

    events.UrlFilter[]

    Kondisi yang harus dipenuhi oleh URL yang dibuka. 'Skema' dan 'port' kolom UrlFilter diabaikan untuk peristiwa ini.

onErrorOccurred

chrome.webNavigation.onErrorOccurred.addListener(
  callback: function,
  filters?: object,
)

Diaktifkan saat terjadi error dan navigasi dibatalkan. Hal ini dapat terjadi jika terjadi error jaringan, atau pengguna membatalkan navigasi.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • documentId

      string

      Chrome 106 dan yang lebih baru

      UUID dokumen yang dimuat.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • error

      string

      Deskripsi error.

    • frameId

      angka

      0 menunjukkan navigasi yang terjadi di jendela konten tab; nilai positif menunjukkan navigasi dalam subframe. ID frame bersifat unik dalam satu tab.

    • frameType

      extensionTypes.FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      Chrome 74 dan yang lebih baru

      ID frame induk, atau -1 jika ini adalah frame utama.

    • processId

      angka

      Tidak digunakan lagi sejak Chrome 50

      processId tidak lagi ditetapkan untuk peristiwa ini.

      Nilai -1.

    • tabId

      angka

      ID tab tempat terjadinya navigasi.

    • timeStamp

      angka

      Waktu saat error terjadi, dalam milidetik sejak epoch.

    • url

      string

• filter

  objek opsional

  • url

    events.UrlFilter[]

    Kondisi yang harus dipenuhi oleh URL yang dibuka. 'Skema' dan 'port' kolom UrlFilter diabaikan untuk peristiwa ini.

onHistoryStateUpdated

chrome.webNavigation.onHistoryStateUpdated.addListener(
  callback: function,
  filters?: object,
)

Diaktifkan saat histori frame diperbarui ke URL baru. Semua peristiwa mendatang untuk frame tersebut akan menggunakan URL yang diperbarui.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • documentId

      string

      Chrome 106 dan yang lebih baru

      UUID dokumen yang dimuat.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • frameId

      angka

      0 menunjukkan navigasi yang terjadi di jendela konten tab; nilai positif menunjukkan navigasi dalam subframe. ID frame bersifat unik dalam satu tab.

    • frameType

      extensionTypes.FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      Chrome 74 dan yang lebih baru

      ID frame induk, atau -1 jika ini adalah frame utama.

    • processId

      angka

      ID proses yang menjalankan perender untuk frame ini.

    • tabId

      angka

      ID tab tempat terjadinya navigasi.

    • timeStamp

      angka

      Waktu saat navigasi di-commit, dalam milidetik sejak epoch.

    • transitionQualifiers

      TransitionQualifier[]

      Daftar penentu transisi.

    • transitionType

      TransitionType

      Penyebab navigasi.

    • url

      string

• filter

  objek opsional

  • url

    events.UrlFilter[]

    Kondisi yang harus dipenuhi oleh URL yang dibuka. 'Skema' dan 'port' kolom UrlFilter diabaikan untuk peristiwa ini.

onReferenceFragmentUpdated

chrome.webNavigation.onReferenceFragmentUpdated.addListener(
  callback: function,
  filters?: object,
)

Diaktifkan saat fragmen referensi frame diperbarui. Semua peristiwa mendatang untuk frame tersebut akan menggunakan URL yang diperbarui.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • documentId

      string

      Chrome 106 dan yang lebih baru

      UUID dokumen yang dimuat.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 dan yang lebih baru

      Siklus proses dokumen berada.

    • frameId

      angka

      0 menunjukkan navigasi yang terjadi di jendela konten tab; nilai positif menunjukkan navigasi dalam subframe. ID frame bersifat unik dalam satu tab.

    • frameType

      extensionTypes.FrameType

      Chrome 106 dan yang lebih baru

      Jenis frame tempat navigasi terjadi.

    • parentDocumentId

      string opsional

      Chrome 106 dan yang lebih baru

      UUID dokumen induk yang memiliki frame ini. ID ini tidak disetel jika tidak ada induk.

    • parentFrameId

      angka

      Chrome 74 dan yang lebih baru

      ID frame induk, atau -1 jika ini adalah frame utama.

    • processId

      angka

      ID proses yang menjalankan perender untuk frame ini.

    • tabId

      angka

      ID tab tempat terjadinya navigasi.

    • timeStamp

      angka

      Waktu saat navigasi di-commit, dalam milidetik sejak epoch.

    • transitionQualifiers

      TransitionQualifier[]

      Daftar penentu transisi.

    • transitionType

      TransitionType

      Penyebab navigasi.

    • url

      string

• filter

  objek opsional

  • url

    events.UrlFilter[]

    Kondisi yang harus dipenuhi oleh URL yang dibuka. 'Skema' dan 'port' kolom UrlFilter diabaikan untuk peristiwa ini.

onTabReplaced

chrome.webNavigation.onTabReplaced.addListener(
  callback: function,
)

Diaktifkan saat konten tab diganti dengan tab lain (biasanya yang telah dipra-render).

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • replacedTabId

      angka

      ID tab yang diganti.

    • tabId

      angka

      ID tab yang menggantikan tab lama.

    • timeStamp

      angka

      Waktu saat penggantian terjadi, dalam milidetik sejak epoch.