chrome.webNavigation

Descrizione

Utilizza l'API chrome.webNavigation per ricevere notifiche sullo stato delle richieste di navigazione in corso.

Autorizzazioni

webNavigation

Manifest

Tutti i metodi e gli eventi chrome.webNavigation richiedono la dichiarazione di "web Browsing" autorizzazione nel manifest dell'estensione. Ad esempio:

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

Ordine evento

Per completare una navigazione, gli eventi vengono attivati nel seguente ordine:

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

Qualsiasi errore che si verifica durante il processo genera un evento onErrorOccurred. Per una specifica navigazione, non ci sono altri eventi attivati dopo il giorno onErrorOccurred.

Se un frame di navigazione contiene frame secondari, il relativo onCommitted viene attivato prima di qualsiasi altro frame secondario. onBeforeNavigate; mentre onCompleted viene attivato dopo tutti gli onCompleted dei relativi figli.

Se viene modificato il frammento di riferimento di un frame, viene attivato un evento onReferenceFragmentUpdated. Questo può attivarsi in qualsiasi momento dopo il giorno onDOMContentLoaded, anche dopo il giorno onCompleted.

Se l'API History viene utilizzata per modificare lo stato di un frame (ad es. usando history.pushState(), un È stato attivato onHistoryStateUpdated evento. Questo evento può essere attivato in qualsiasi momento dopo il giorno onDOMContentLoaded.

Se durante la navigazione è stata ripristinata una pagina dalla cache back-forward, l'evento onDOMContentLoaded non si attiverà. L'evento non è stato attivato perché il caricamento dei contenuti è già stato completato quando la pagina visitato per la prima volta.

Se è stata attivata una navigazione tramite Chrome Instant o Pagine istantanee, un file pagina viene scambiata nella scheda corrente. In questo caso, viene attivato un evento onTabReplaced.

Relazione con gli eventi webRequest

Non esiste un ordinamento definito tra gli eventi dell'API webRequest e quelli dell'evento API webNavigator. È possibile che gli eventi webRequest vengano comunque ricevuti per i frame che ha avviato una nuova navigazione o che una navigazione prosegua solo dopo che le risorse di rete sono già state completamente caricato.

In generale, gli eventi di navigazione web sono strettamente correlati allo stato di navigazione visualizzato. nell'interfaccia utente, mentre gli eventi webRequest corrispondono allo stato dello stack di rete, generalmente poco visibili all'utente.

ID scheda

Non tutte le schede di navigazione corrispondono alle schede effettive nell'interfaccia utente di Chrome, ad esempio una scheda che viene sottoposti a prerendering. Queste schede non sono accessibili tramite l'API Tabs e non puoi richiedere informazioni tramite webNavigation.getFrame o webNavigation.getAllFrames. Una volta scambiata viene attivato un evento onTabReplaced che diventa accessibile tramite queste API.

Timestamp

È importante notare che alcune stranezze tecniche nella gestione da parte del sistema operativo di possono causare un disallineamento dell'orologio tra il browser stesso e i processi delle estensioni. Questo significa che gli eventi di WebNavigatore La proprietà timeStamp è garantita solo internamente coerente. Confrontando un evento con un altro, otterrai l'offset corretto, ma confrontandole con l'ora corrente all'interno dell'estensione (tramite (new Date()).getTime(), ad esempio) potrebbe restituire risultati imprevisti.

ID frame

I frame all'interno di una scheda possono essere identificati da un ID frame. L'ID frame del frame principale è sempre 0, L'ID dei frame secondari è un numero positivo. Una volta creato il documento in un frame, il relativo ID frame rimane costante per tutta la durata del documento. A partire da Chrome 49, questo ID è costante anche per la durata del frame (tra più navigazioni).

A causa della natura multi-processo di Chrome, una scheda potrebbe utilizzare processi diversi per eseguire il rendering dell'origine e la destinazione di una pagina web. Pertanto, se una navigazione avviene in un nuovo processo, puoi Ricevere eventi sia dalla nuova che dalla vecchia pagina fino a quando non viene eseguito il commit della nuova navigazione (ad es. onCommitted evento inviato per il nuovo frame principale). In altre parole, è possibile avere più di una sequenza in attesa di eventi webNavigator con lo stesso frameId. Le sequenze possono essere distinti per la chiave processId.

Tieni inoltre presente che durante un caricamento provvisorio il processo potrebbe essere cambiato più volte. Ciò accade quando il caricamento viene reindirizzato a un sito diverso. In questo caso, riceverai ripetuti Eventi onBeforeNavigate e onErrorOccurred, fino a quando non riceverai l'evento onCommitted finale.

Un altro concetto problematico con le estensioni è il ciclo di vita del frame. Un frame ospita un documento (che è associato a un URL di cui è stato eseguito il commit). Il documento può cambiare, ad esempio navigando, al contrario del frameId, quindi è difficile associare che sia successo qualcosa in un documento specifico con solo frameIds. Stiamo introducendo un concetto di documentId che è un identificatore univoco per documento. Se un frame viene esplorato e apre una nuovo documento, l'identificatore cambierà. Questo campo è utile per determinare Quando le pagine cambiano il proprio stato del ciclo di vita (tra prerendering/attivo/cached). perché rimane lo stesso.

Tipi di transizione e qualificatori

L'evento onCommitted dell'API webNavigator ha un transitionType e un transitionQualifiers proprietà. Il tipo di transizione è lo stesso utilizzato nell'API History che descrive il modo in cui browser ha raggiunto l'URL in questione. Inoltre, è possibile eseguire diversi qualificatori di transizione che definiscono ulteriormente la navigazione.

Esistono i seguenti qualificatori di transizione:

Qualificatore della transizioneDescrizione
"client_redirect"Si sono verificati uno o più reindirizzamenti causati da JavaScript o tag meta refresh nella pagina durante la navigazione.
"server_redirect"Si sono verificati uno o più reindirizzamenti causati dalle intestazioni HTTP inviate dal server durante la navigazione.
"forward_back"L'utente ha utilizzato il pulsante Avanti o Indietro per avviare la navigazione.
"from_address_bar"L'utente ha avviato la navigazione dalla barra degli indirizzi (nota anche come Omnibox).

Esempi

Per provare questa API, installa l'esempio dell'API webNavigator da chrome-extension-samples repository Git.

Tipi

TransitionQualifier

Chrome 44 e versioni successive .

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 e versioni successive .

Causa della navigazione. Vengono utilizzati gli stessi tipi di transizione definiti nell'API History. Si tratta degli stessi tipi di transizione definiti nell'API History, ad eccezione di "start_page" al posto di "auto_toplevel" (per la compatibilità con le versioni precedenti).

Enum

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"generato"

"start_page"

"form_submit"

"ricarica"

"parola chiave"

"keyword_generate"

Metodi

getAllFrames()

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

Recupera le informazioni su tutti i frame di una determinata scheda.

Parametri

  • dettagli

    oggetto

    Informazioni sulla scheda da cui recuperare tutti i frame.

    • tabId

      numero

      L'ID della scheda.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto:

    (details?: object[]) => void

    • dettagli

      oggetto[] facoltativo

      Un elenco di frame nella scheda specificata, nullo se l'ID scheda specificato non è valido.

      • documentId

        stringa

        Chrome 106 e versioni successive .

        Un UUID del documento caricato.

      • documentLifecycle
        Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • errorOccurred

        booleano

        True se l'ultima navigazione in questo frame è stata interrotta per un errore, ad esempio è stato attivato l'evento onErrorOccurred.

      • frameId

        numero

        L'ID del frame. 0 indica che questo è il frame principale; un valore positivo indica l'ID di un frame secondario.

      • frameType
        Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        L'ID del frame principale o -1 se questo è il frame principale.

      • processId

        numero

        L'ID del processo che esegue il renderer per questo frame.

      • url

        stringa

        L'URL attualmente associato a questo frame.

Resi

  • Promise<object[] | non definito>

    Chrome 93 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getFrame()

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

Recupera le informazioni sul frame specificato. Un frame fa riferimento a un <iframe> o un <frame> di una pagina web ed è identificata da un ID scheda e un ID frame.

Parametri

  • dettagli

    oggetto

    Informazioni sul frame su cui recuperare le informazioni.

    • documentId

      stringa facoltativo

      Chrome 106 e versioni successive .

      L'UUID del documento. Se frameId e/o tabId vengono forniti, verranno convalidati in modo da corrispondere al documento trovato dall'ID documento fornito.

    • frameId

      numero facoltativo

      L'ID del frame nella scheda specificata.

    • processId

      numero facoltativo

      Ritirato da Chrome 49

      I frame sono ora identificati in modo univoco dall'ID scheda e dall'ID frame. l'ID di processo non è più necessario e pertanto viene ignorato.

      L'ID del processo che esegue il renderer per questa scheda.

    • tabId

      numero facoltativo

      L'ID della scheda in cui si trova il frame.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto:

    (details?: object) => void

    • dettagli

      oggetto facoltativo

      Informazioni sul frame richiesto, nulle se l'ID frame e/o l'ID scheda specificati non sono validi.

      • documentId

        stringa

        Chrome 106 e versioni successive .

        Un UUID del documento caricato.

      • documentLifecycle
        Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • errorOccurred

        booleano

        True se l'ultima navigazione in questo frame è stata interrotta per un errore, ad esempio è stato attivato l'evento onErrorOccurred.

      • frameType
        Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        L'ID del frame principale o -1 se questo è il frame principale.

      • url

        stringa

        L'URL attualmente associato a questo frame, se il frame identificato da frameId esisteva in un determinato punto della scheda specificata. Il fatto che un URL sia associato a un determinato frameId non implica che il frame corrispondente esista ancora.

Resi

  • Promise&lt;object | non definito>

    Chrome 93 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

Eventi

onBeforeNavigate

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

Attivato quando sta per verificarsi una navigazione.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • frameId

        numero

        0 indica che la navigazione avviene nella finestra del contenuto della scheda; un valore positivo indica la navigazione in un frame secondario. Gli ID frame sono univoci per una determinata scheda e un determinato processo.

      • Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        L'ID del frame principale o -1 se questo è il frame principale.

      • processId

        numero

        Ritirato da Chrome 50

        Il processId non è più impostato per questo evento, poiché il processo che renderà il documento risultante non è noto fino a onCommit.

        Il valore -1.

      • tabId

        numero

        L'ID della scheda in cui sta per verificarsi la navigazione.

      • timeStamp

        numero

        Il tempo in cui il browser stava per avviare la navigazione, in millisecondi dall'epoca.

      • url

        stringa

  • filtri

    oggetto facoltativo

    • Condizioni che devono essere soddisfatte dall'URL raggiunto. Lo "schemi" e "ports" di UrlFilter vengono ignorati per questo evento.

onCommitted

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

Attivato quando viene eseguito il commit di una navigazione. È possibile che il download del documento (e delle risorse a cui fa riferimento, come immagini e frame secondari) sia ancora in corso, ma almeno parte del documento è stata ricevuta dal server e il browser ha deciso di passare al nuovo documento.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • documentId

        stringa

        Chrome 106 e versioni successive .

        Un UUID del documento caricato.

      • Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • frameId

        numero

        0 indica che la navigazione avviene nella finestra del contenuto della scheda; un valore positivo indica la navigazione in un frame secondario. Gli ID frame sono univoci all'interno di una scheda.

      • Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        Chrome 74 e versioni successive .

        L'ID del frame principale o -1 se questo è il frame principale.

      • processId

        numero

        L'ID del processo che esegue il renderer per questo frame.

      • tabId

        numero

        L'ID della scheda in cui viene effettuata la navigazione.

      • timeStamp

        numero

        Il tempo in cui è stato eseguito il commit della navigazione, in millisecondi dall'epoca.

      • transitionQualifiers

        Un elenco di qualificatori di transizione.

      • transitionType

        Causa della navigazione.

      • url

        stringa

  • filtri

    oggetto facoltativo

    • Condizioni che devono essere soddisfatte dall'URL raggiunto. Lo "schemi" e "ports" di UrlFilter vengono ignorati per questo evento.

onCompleted

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

Attivato quando un documento, incluse le risorse a cui fa riferimento, viene completamente caricato e inizializzato.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • documentId

        stringa

        Chrome 106 e versioni successive .

        Un UUID del documento caricato.

      • Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • frameId

        numero

        0 indica che la navigazione avviene nella finestra del contenuto della scheda; un valore positivo indica la navigazione in un frame secondario. Gli ID frame sono univoci all'interno di una scheda.

      • Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        Chrome 74 e versioni successive .

        L'ID del frame principale o -1 se questo è il frame principale.

      • processId

        numero

        L'ID del processo che esegue il renderer per questo frame.

      • tabId

        numero

        L'ID della scheda in cui viene effettuata la navigazione.

      • timeStamp

        numero

        Il tempo di completamento del caricamento del documento, in millisecondi dall'epoca.

      • url

        stringa

  • filtri

    oggetto facoltativo

    • Condizioni che devono essere soddisfatte dall'URL raggiunto. Lo "schemi" e "ports" di UrlFilter vengono ignorati per questo evento.

onCreatedNavigationTarget

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

Attivato quando viene creata una nuova finestra o una nuova scheda in una finestra esistente per ospitare una navigazione.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • sourceFrameId

        numero

        L'ID del frame con sourceTabId in cui viene attivata la navigazione. 0 indica il frame principale.

      • sourceProcessId

        numero

        L'ID del processo che esegue il renderer per il frame di origine.

      • sourceTabId

        numero

        L'ID della scheda in cui viene attivata la navigazione.

      • tabId

        numero

        L'ID della scheda in cui è aperto l'URL

      • timeStamp

        numero

        Il tempo in cui il browser stava per creare una nuova visualizzazione, in millisecondi dall'epoca.

      • url

        stringa

        L'URL da aprire nella nuova finestra.

  • filtri

    oggetto facoltativo

    • Condizioni che devono essere soddisfatte dall'URL raggiunto. Lo "schemi" e "ports" di UrlFilter vengono ignorati per questo evento.

onDOMContentLoaded

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

Viene attivato quando la creazione del DOM della pagina è stata completata, ma il caricamento delle risorse a cui viene fatto riferimento potrebbe non terminare.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • documentId

        stringa

        Chrome 106 e versioni successive .

        Un UUID del documento caricato.

      • Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • frameId

        numero

        0 indica che la navigazione avviene nella finestra del contenuto della scheda; un valore positivo indica la navigazione in un frame secondario. Gli ID frame sono univoci all'interno di una scheda.

      • Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        Chrome 74 e versioni successive .

        L'ID del frame principale o -1 se questo è il frame principale.

      • processId

        numero

        L'ID del processo che esegue il renderer per questo frame.

      • tabId

        numero

        L'ID della scheda in cui viene effettuata la navigazione.

      • timeStamp

        numero

        L'ora in cui è stato creato completamente il DOM della pagina, in millisecondi dall'epoca.

      • url

        stringa

  • filtri

    oggetto facoltativo

    • Condizioni che devono essere soddisfatte dall'URL raggiunto. Lo "schemi" e "ports" di UrlFilter vengono ignorati per questo evento.

onErrorOccurred

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

Attivato quando si verifica un errore e la navigazione viene interrotta. Questo può accadere se si è verificato un errore di rete o l'utente ha interrotto la navigazione.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • documentId

        stringa

        Chrome 106 e versioni successive .

        Un UUID del documento caricato.

      • Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • errore

        stringa

        La descrizione dell'errore.

      • frameId

        numero

        0 indica che la navigazione avviene nella finestra del contenuto della scheda; un valore positivo indica la navigazione in un frame secondario. Gli ID frame sono univoci all'interno di una scheda.

      • Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        Chrome 74 e versioni successive .

        L'ID del frame principale o -1 se questo è il frame principale.

      • processId

        numero

        Ritirato da Chrome 50

        Il processId non è più impostato per questo evento.

        Il valore -1.

      • tabId

        numero

        L'ID della scheda in cui viene effettuata la navigazione.

      • timeStamp

        numero

        Il tempo in cui si è verificato l'errore, in millisecondi dall'epoca.

      • url

        stringa

  • filtri

    oggetto facoltativo

    • Condizioni che devono essere soddisfatte dall'URL raggiunto. Lo "schemi" e "ports" di UrlFilter vengono ignorati per questo evento.

onHistoryStateUpdated

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

Attivato quando la cronologia del frame è stata aggiornata a un nuovo URL. Tutti gli eventi futuri per quel frame utilizzeranno l'URL aggiornato.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • documentId

        stringa

        Chrome 106 e versioni successive .

        Un UUID del documento caricato.

      • Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • frameId

        numero

        0 indica che la navigazione avviene nella finestra del contenuto della scheda; un valore positivo indica la navigazione in un frame secondario. Gli ID frame sono univoci all'interno di una scheda.

      • Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        Chrome 74 e versioni successive .

        L'ID del frame principale o -1 se questo è il frame principale.

      • processId

        numero

        L'ID del processo che esegue il renderer per questo frame.

      • tabId

        numero

        L'ID della scheda in cui viene effettuata la navigazione.

      • timeStamp

        numero

        Il tempo in cui è stato eseguito il commit della navigazione, in millisecondi dall'epoca.

      • transitionQualifiers

        Un elenco di qualificatori di transizione.

      • transitionType

        Causa della navigazione.

      • url

        stringa

  • filtri

    oggetto facoltativo

    • Condizioni che devono essere soddisfatte dall'URL raggiunto. Lo "schemi" e "ports" di UrlFilter vengono ignorati per questo evento.

onReferenceFragmentUpdated

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

Attivato quando è stato aggiornato il frammento di riferimento di un frame. Tutti gli eventi futuri per quel frame utilizzeranno l'URL aggiornato.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • documentId

        stringa

        Chrome 106 e versioni successive .

        Un UUID del documento caricato.

      • Chrome 106 e versioni successive .

        Il ciclo di vita del documento.

      • frameId

        numero

        0 indica che la navigazione avviene nella finestra del contenuto della scheda; un valore positivo indica la navigazione in un frame secondario. Gli ID frame sono univoci all'interno di una scheda.

      • Chrome 106 e versioni successive .

        Il tipo di frame in cui è avvenuta la navigazione.

      • parentDocumentId

        stringa facoltativo

        Chrome 106 e versioni successive .

        Un UUID del documento padre a cui appartiene questo frame. Questa opzione non è impostata se non è presente alcun padre.

      • parentFrameId

        numero

        Chrome 74 e versioni successive .

        L'ID del frame principale o -1 se questo è il frame principale.

      • processId

        numero

        L'ID del processo che esegue il renderer per questo frame.

      • tabId

        numero

        L'ID della scheda in cui viene effettuata la navigazione.

      • timeStamp

        numero

        Il tempo in cui è stato eseguito il commit della navigazione, in millisecondi dall'epoca.

      • transitionQualifiers

        Un elenco di qualificatori di transizione.

      • transitionType

        Causa della navigazione.

      • url

        stringa

  • filtri

    oggetto facoltativo

    • Condizioni che devono essere soddisfatte dall'URL raggiunto. Lo "schemi" e "ports" di UrlFilter vengono ignorati per questo evento.

onTabReplaced

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

Attivato quando i contenuti della scheda vengono sostituiti da un'altra scheda (solitamente in precedenza prerenderizzata).

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    (details: object) => void

    • dettagli

      oggetto

      • replacedTabId

        numero

        L'ID della scheda che è stata sostituita.

      • tabId

        numero

        L'ID della scheda che ha sostituito la vecchia scheda.

      • timeStamp

        numero

        Il tempo in cui è avvenuta la sostituzione, in millisecondi dall'epoca.