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 transisiDeskripsi
"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.
&quot;from_address_bar&quot;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

      • 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.

      • 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

    • 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.

      • 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.

      • 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

    • 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.

      • 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.

      • 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

    • 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

    • 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.

      • 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.

      • 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

    • 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.

      • 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.

      • 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

    • 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.

      • 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.

      • 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

    • 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.

      • 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.

      • 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

    • 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.