chrome.webNavigation

refresh date: 2026-09-25 robots: noindex

Opis

Używaj interfejsu API chrome.webNavigation, aby otrzymywać powiadomienia o stanie żądań nawigacji w trakcie lotu.

Uprawnienia

webNavigation

To uprawnienie powoduje wyświetlenie ostrzeżenia.

Plik manifestu

Wszystkie metody i zdarzenia chrome.webNavigation wymagają zadeklarowania uprawnienia „webNavigation” w pliku manifestu rozszerzenia. Na przykład:

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

Kolejność zdarzeń

W przypadku pomyślnie zakończonej nawigacji zdarzenia są wywoływane w tej kolejności:

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

Każdy błąd występujący w trakcie procesu powoduje zdarzenie onErrorOccurred. W przypadku konkretnej nawigacji po zdarzeniu onErrorOccurred nie są wywoływane żadne kolejne zdarzenia.

Jeśli ramka nawigacyjna zawiera podramki, jej zdarzenie onCommitted jest wywoływane przed zdarzeniem onBeforeNavigate dowolnego z jej elementów podrzędnych, a zdarzenie onCompleted jest wywoływane po zdarzeniu onCompleted wszystkich jej elementów podrzędnych.

Jeśli fragment referencyjny ramki zostanie zmieniony, wywoływane jest zdarzenie onReferenceFragmentUpdated. To zdarzenie może zostać wywołane w dowolnym momencie po onDOMContentLoaded, nawet po onCompleted.

Jeśli interfejs API historii jest używany do modyfikowania stanu ramki (np. za pomocą history.pushState()), wywoływane jest zdarzenie onHistoryStateUpdated. To zdarzenie może zostać wywołane w dowolnym momencie po onDOMContentLoaded.

Jeśli nawigacja przywróciła stronę z pamięci podręcznej stanu strony internetowej, zdarzenie onDOMContentLoaded nie zostanie wywołane. Zdarzenie nie jest wywoływane, ponieważ treść została już wczytana podczas pierwszej wizyty na stronie.

Jeśli nawigacja została wywołana przez wyszukiwanie dynamiczne w Chrome lub Błyskawiczne strony, w bieżącej karcie zostanie wyświetlona całkowicie załadowana strona. W takim przypadku wywoływane jest zdarzenie onTabReplaced.

Związek ze zdarzeniami webRequest

Nie ma określonej kolejności zdarzeń interfejsu API webRequest i zdarzeń interfejsu API webNavigation. Możliwe, że zdarzenia webRequest są nadal odbierane w przypadku ramek, które już rozpoczęły nową nawigację, lub że nawigacja jest kontynuowana dopiero po pełnym załadowaniu zasobów sieciowych.

Ogólnie rzecz biorąc, zdarzenia webNavigation są ściśle powiązane ze stanem nawigacji wyświetlanym w interfejsie, a zdarzenia webRequest odpowiadają stanowi stosu sieciowego, który jest zwykle niewidoczny dla użytkownika.

Identyfikatory kart

Nie wszystkie karty nawigacyjne odpowiadają rzeczywistym kartom w interfejsie Chrome, np. karta, która jest wstępnie renderowana. Takie karty nie są dostępne przez interfejs API kart, nie można też prosić o informacje o nich za pomocą webNavigation.getFrame ani webNavigation.getAllFrames. Po zamianie takiej karty wywoływane jest zdarzenie onTabReplaced i staje się ona dostępna za pomocą tych interfejsów API.

Sygnatury czasowe

Pamiętaj, że niektóre techniczne osobliwości w obsłudze różnych procesów Chrome przez system operacyjny mogą powodować rozbieżności między zegarem samej przeglądarki a zegarem procesów rozszerzeń. Oznacza to, że właściwość timeStamp zdarzeń WebNavigation jest spójna tylko wewnętrznie. Porównanie jednego zdarzenia z innym da prawidłowe przesunięcie między nimi, ale porównanie ich z bieżącym czasem w rozszerzeniu (np. za pomocą (new Date()).getTime()) może dać nieoczekiwane wyniki.

Identyfikatory ramek

Ramki na karcie można zidentyfikować po identyfikatorze ramki. Identyfikator ramki głównej to zawsze 0, a identyfikator ramek podrzędnych to liczba dodatnia. Po utworzeniu dokumentu w ramce identyfikator ramki pozostaje niezmienny przez cały okres istnienia dokumentu. Od wersji Chrome 49 ten identyfikator jest też stały przez cały czas istnienia ramki (w przypadku wielu nawigacji).

Ze względu na wieloprocesowy charakter Chrome karta może używać różnych procesów do renderowania źródła i miejsca docelowego strony internetowej. Dlatego jeśli nawigacja odbywa się w nowym procesie, możesz otrzymywać zdarzenia zarówno z nowej, jak i ze starej strony, dopóki nowa nawigacja nie zostanie zatwierdzona (czyli dopóki nie zostanie wysłane zdarzenie onCommitted dla nowej ramki głównej). Innymi słowy, możliwe jest, że istnieje więcej niż 1 oczekująca sekwencja zdarzeń webNavigation z tym samym identyfikatorem frameId. Sekwencje można rozróżnić za pomocą klucza processId.

Pamiętaj też, że podczas tymczasowego wczytywania proces może zostać przełączony kilka razy. Dzieje się tak, gdy obciążenie jest przekierowywane do innej witryny. W takim przypadku będziesz otrzymywać powtarzające się zdarzenia onBeforeNavigate i onErrorOccurred, dopóki nie otrzymasz ostatniego zdarzenia onCommitted.

Innym problematycznym aspektem rozszerzeń jest cykl życia ramki. Ramka zawiera dokument (powiązany z zatwierdzonym adresem URL). Dokument może się zmienić (np. przez nawigację), ale frameId nie, więc trudno jest powiązać zdarzenie w konkretnym dokumencie z samymi identyfikatorami frameId. Wprowadzamy pojęcie documentId, czyli unikalnego identyfikatora dokumentu. Jeśli ramka zostanie otwarta i otworzy nowy dokument, identyfikator się zmieni. To pole jest przydatne do określania, kiedy strony zmieniają stan cyklu życia (między renderowaniem wstępnym, aktywnym i zapisanym w pamięci podręcznej), ponieważ pozostaje takie samo.

Typy przejść i kwalifikatory

Zdarzenie onCommitted interfejsu webNavigation API ma właściwości transitionType i transitionQualifiers. Typ przejścia jest taki sam jak w interfejsie API historii i opisuje, jak przeglądarka przeszła do tego konkretnego adresu URL. Dodatkowo może zostać zwróconych kilka kwalifikatorów przejścia, które dokładniej definiują nawigację.

Dostępne są te kwalifikatory przejścia:

Kwalifikator przejścia	Opis
„client_redirect”	Podczas nawigacji nastąpiło co najmniej 1 przekierowanie spowodowane przez kod JavaScript lub tagi meta refresh na stronie.
"server_redirect"	Podczas nawigacji wystąpiło co najmniej 1 przekierowanie spowodowane przez nagłówki HTTP wysłane z serwera.
„forward_back”	Użytkownik użył przycisku Dalej lub Wstecz, aby rozpocząć nawigację.
"from_address_bar"	Użytkownik zainicjował nawigację z paska adresu (omniboksu).

Przykłady

Aby wypróbować ten interfejs API, zainstaluj przykład interfejsu webNavigation API z repozytorium chrome-extension-samples.

Typy

TransitionQualifier

Chrome 44 lub nowsza wersja

Typ wyliczeniowy

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 lub nowsza wersja

Przyczyna nawigacji. Używane są te same typy przejść, które są zdefiniowane w interfejsie API historii. Są to te same typy przejść, które są zdefiniowane w interfejsie API historii, z tym że "start_page" zastępuje "auto_toplevel" (ze względu na zgodność wsteczną).

Typ wyliczeniowy

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"generated"

"start_page"

"form_submit"

"reload"

"keyword"

"keyword_generated"

Metody

getAllFrames()

Obietnica

chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
): Promise<object[] | undefined>

Pobiera informacje o wszystkich ramkach danej karty.

Parametry

• szczegóły

  obiekt

  Informacje o karcie, z której mają zostać pobrane wszystkie ramki.

  • tabId

    liczba

    Identyfikator karty.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (details?: object[]) => void

  • szczegóły

    object[] opcjonalny

    Lista ramek na danej karcie lub wartość null, jeśli podany identyfikator karty jest nieprawidłowy.

    • documentId

      tekst

      Chrome 106 lub nowsza wersja

      Identyfikator UUID wczytanego dokumentu.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • errorOccurred

      wartość logiczna

      Prawda, jeśli ostatnia nawigacja w tej ramce została przerwana przez błąd, czyli zostało wywołane zdarzenie onErrorOccurred.

    • frameId

      liczba

      Identyfikator ramki. 0 oznacza, że jest to ramka główna, a wartość dodatnia wskazuje identyfikator ramki podrzędnej.

    • frameType

      FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • processId

      liczba

      Identyfikator procesu, który uruchamia mechanizm renderowania dla tej ramki.

    • URL

      tekst

      Adres URL powiązany obecnie z tą ramką.

Zwroty

• Promise<object[] | undefined>

  Chrome 93 lub nowsza wersja

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getFrame()

Obietnica

chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
): Promise<object | undefined>

Pobiera informacje o danej ramce. Ramka odnosi się do elementu <iframe> lub <frame> strony internetowej i jest identyfikowana przez identyfikator karty i identyfikator ramki.

Parametry

• szczegóły

  obiekt

  Informacje o ramce, o której chcesz uzyskać informacje.

  • documentId

    ciąg znaków opcjonalny

    Chrome 106 lub nowsza wersja

    Identyfikator UUID dokumentu. Jeśli podano identyfikator frameId lub tabId, zostaną one zweryfikowane pod kątem zgodności z dokumentem znalezionym na podstawie podanego identyfikatora dokumentu.

  • frameId

    number optional

    Identyfikator ramki na danej karcie.

  • processId

    number optional

    Wycofane od Chrome 49

    Ramki są teraz jednoznacznie identyfikowane przez identyfikator karty i identyfikator ramki. Identyfikator procesu nie jest już potrzebny i jest ignorowany.

    Identyfikator procesu, który uruchamia mechanizm renderowania dla tej karty.

  • tabId

    number optional

    Identyfikator karty, na której znajduje się ramka.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (details?: object) => void

  • szczegóły

    object opcjonalny

    Informacje o żądanej ramce. Wartość null, jeśli podany identyfikator ramki lub karty jest nieprawidłowy.

    • documentId

      tekst

      Chrome 106 lub nowsza wersja

      Identyfikator UUID wczytanego dokumentu.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • errorOccurred

      wartość logiczna

      Prawda, jeśli ostatnia nawigacja w tej ramce została przerwana przez błąd, czyli zostało wywołane zdarzenie onErrorOccurred.

    • frameType

      FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • URL

      tekst

      Adres URL powiązany obecnie z tą ramką, jeśli ramka określona przez frameId istniała w danym momencie na danej karcie. Fakt, że adres URL jest powiązany z danym identyfikatorem frameId, nie oznacza, że odpowiednia ramka nadal istnieje.

Zwroty

• Promise<object | undefined>

  Chrome 93 lub nowsza wersja

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onBeforeNavigate

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

Uruchamiane, gdy ma nastąpić nawigacja.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • frameId

      liczba

      0 oznacza, że nawigacja odbywa się w oknie zawartości karty, a wartość dodatnia oznacza nawigację w ramce podrzędnej. Identyfikatory ramek są unikalne dla danej karty i procesu.

    • frameType

      extensionTypes.FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • processId

      liczba

      Wycofane od Chrome 50

      Właściwość processId nie jest już ustawiana dla tego zdarzenia, ponieważ proces, który wyrenderuje wynikowy dokument, nie jest znany do momentu onCommit.

      Wartość -1.

    • tabId

      liczba

      Identyfikator karty, na której ma nastąpić nawigacja.

    • timeStamp

      liczba

      Czas, w którym przeglądarka miała rozpocząć nawigację, w milisekundach od początku epoki.

    • URL

      tekst

• filtry

  object opcjonalny

  • URL

    events.UrlFilter[]

    Warunki, które musi spełniać adres URL, do którego następuje przejście.

onCommitted

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

Uruchamiane po zatwierdzeniu nawigacji. Dokument (oraz zasoby, do których się odwołuje, takie jak obrazy i podramki) może być nadal pobierany, ale co najmniej część dokumentu została odebrana z serwera i przeglądarka zdecydowała się przełączyć na nowy dokument.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • documentId

      tekst

      Chrome 106 lub nowsza wersja

      Identyfikator UUID wczytanego dokumentu.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • frameId

      liczba

      0 oznacza, że nawigacja odbywa się w oknie zawartości karty, a wartość dodatnia oznacza nawigację w ramce podrzędnej. Identyfikatory ramek są unikalne w obrębie karty.

    • frameType

      extensionTypes.FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Chrome 74 lub nowsza wersja

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • processId

      liczba

      Identyfikator procesu, który uruchamia mechanizm renderowania dla tej ramki.

    • tabId

      liczba

      Identyfikator karty, na której następuje nawigacja.

    • timeStamp

      liczba

      Czas zatwierdzenia nawigacji w milisekundach od początku epoki.

    • transitionQualifiers

      TransitionQualifier[]

      Lista kwalifikatorów przejścia.

    • transitionType

      TransitionType

      Przyczyna nawigacji.

    • URL

      tekst

• filtry

  object opcjonalny

  • URL

    events.UrlFilter[]

    Warunki, które musi spełniać adres URL, do którego następuje przejście.

onCompleted

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

Uruchamiane, gdy dokument, w tym zasoby, do których się odwołuje, zostanie całkowicie wczytany i zainicjowany.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • documentId

      tekst

      Chrome 106 lub nowsza wersja

      Identyfikator UUID wczytanego dokumentu.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • frameId

      liczba

      0 oznacza, że nawigacja odbywa się w oknie zawartości karty, a wartość dodatnia oznacza nawigację w ramce podrzędnej. Identyfikatory ramek są unikalne w obrębie karty.

    • frameType

      extensionTypes.FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Chrome 74 lub nowsza wersja

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • processId

      liczba

      Identyfikator procesu, który uruchamia mechanizm renderowania dla tej ramki.

    • tabId

      liczba

      Identyfikator karty, na której następuje nawigacja.

    • timeStamp

      liczba

      Czas zakończenia wczytywania dokumentu w milisekundach od początku epoki.

    • URL

      tekst

• filtry

  object opcjonalny

  • URL

    events.UrlFilter[]

    Warunki, które musi spełniać adres URL, do którego następuje przejście.

onCreatedNavigationTarget

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

Uruchamiane, gdy tworzone jest nowe okno lub nowa karta w istniejącym oknie, aby umożliwić nawigację.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • sourceFrameId

      liczba

      Identyfikator ramki z sourceTabId, w której uruchomiono nawigację. 0 oznacza ramkę główną.

    • sourceProcessId

      liczba

      Identyfikator procesu, który uruchamia mechanizm renderowania ramki źródłowej.

    • sourceTabId

      liczba

      Identyfikator karty, na której uruchomiono nawigację.

    • tabId

      liczba

      Identyfikator karty, na której otwarto adres URL.

    • timeStamp

      liczba

      Czas, w którym przeglądarka miała utworzyć nowy widok, w milisekundach od początku epoki.

    • URL

      tekst

      Adres URL, który ma zostać otwarty w nowym oknie.

• filtry

  object opcjonalny

  • URL

    events.UrlFilter[]

    Warunki, które musi spełniać adres URL, do którego następuje przejście.

onDOMContentLoaded

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

Uruchamiane, gdy model DOM strony jest w pełni skonstruowany, ale zasoby, do których się odwołuje, mogą nie zostać w pełni wczytane.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • documentId

      tekst

      Chrome 106 lub nowsza wersja

      Identyfikator UUID wczytanego dokumentu.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • frameId

      liczba

      0 oznacza, że nawigacja odbywa się w oknie zawartości karty, a wartość dodatnia oznacza nawigację w ramce podrzędnej. Identyfikatory ramek są unikalne w obrębie karty.

    • frameType

      extensionTypes.FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Chrome 74 lub nowsza wersja

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • processId

      liczba

      Identyfikator procesu, który uruchamia mechanizm renderowania dla tej ramki.

    • tabId

      liczba

      Identyfikator karty, na której następuje nawigacja.

    • timeStamp

      liczba

      Czas, w którym model DOM strony został w pełni utworzony, w milisekundach od początku epoki.

    • URL

      tekst

• filtry

  object opcjonalny

  • URL

    events.UrlFilter[]

    Warunki, które musi spełniać adres URL, do którego następuje przejście.

onErrorOccurred

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

Uruchamiane, gdy wystąpi błąd i nawigacja zostanie przerwana. Może się tak zdarzyć, jeśli wystąpił błąd sieci lub użytkownik przerwał nawigację.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • documentId

      tekst

      Chrome 106 lub nowsza wersja

      Identyfikator UUID wczytanego dokumentu.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • błąd

      tekst

      Opis błędu.

    • frameId

      liczba

      0 oznacza, że nawigacja odbywa się w oknie zawartości karty, a wartość dodatnia oznacza nawigację w ramce podrzędnej. Identyfikatory ramek są unikalne w obrębie karty.

    • frameType

      extensionTypes.FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Chrome 74 lub nowsza wersja

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • processId

      liczba

      Wycofane od Chrome 50

      Identyfikator processId nie jest już ustawiony dla tego zdarzenia.

      Wartość -1.

    • tabId

      liczba

      Identyfikator karty, na której następuje nawigacja.

    • timeStamp

      liczba

      Czas wystąpienia błędu w milisekundach od początku epoki.

    • URL

      tekst

• filtry

  object opcjonalny

  • URL

    events.UrlFilter[]

    Warunki, które musi spełniać adres URL, do którego następuje przejście.

onHistoryStateUpdated

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

Uruchamiane, gdy historia ramki została zaktualizowana do nowego adresu URL. Wszystkie przyszłe wydarzenia w tej ramce będą używać zaktualizowanego adresu URL.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • documentId

      tekst

      Chrome 106 lub nowsza wersja

      Identyfikator UUID wczytanego dokumentu.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • frameId

      liczba

      0 oznacza, że nawigacja odbywa się w oknie zawartości karty, a wartość dodatnia oznacza nawigację w ramce podrzędnej. Identyfikatory ramek są unikalne w obrębie karty.

    • frameType

      extensionTypes.FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Chrome 74 lub nowsza wersja

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • processId

      liczba

      Identyfikator procesu, który uruchamia mechanizm renderowania dla tej ramki.

    • tabId

      liczba

      Identyfikator karty, na której następuje nawigacja.

    • timeStamp

      liczba

      Czas zatwierdzenia nawigacji w milisekundach od początku epoki.

    • transitionQualifiers

      TransitionQualifier[]

      Lista kwalifikatorów przejścia.

    • transitionType

      TransitionType

      Przyczyna nawigacji.

    • URL

      tekst

• filtry

  object opcjonalny

  • URL

    events.UrlFilter[]

    Warunki, które musi spełniać adres URL, do którego następuje przejście.

onReferenceFragmentUpdated

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

Uruchamiane, gdy fragment referencyjny ramki został zaktualizowany. Wszystkie przyszłe wydarzenia w tej ramce będą używać zaktualizowanego adresu URL.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • documentId

      tekst

      Chrome 106 lub nowsza wersja

      Identyfikator UUID wczytanego dokumentu.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 lub nowsza wersja

      Cykl życia, w którym znajduje się dokument.

    • frameId

      liczba

      0 oznacza, że nawigacja odbywa się w oknie zawartości karty, a wartość dodatnia oznacza nawigację w ramce podrzędnej. Identyfikatory ramek są unikalne w obrębie karty.

    • frameType

      extensionTypes.FrameType

      Chrome 106 lub nowsza wersja

      Typ ramki, w której nastąpiła nawigacja.

    • parentDocumentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowsza wersja

      Identyfikator UUID dokumentu nadrzędnego, do którego należy ta ramka. Jeśli nie ma elementu nadrzędnego, ta wartość nie jest ustawiona.

    • parentFrameId

      liczba

      Chrome 74 lub nowsza wersja

      Identyfikator ramki nadrzędnej lub -1, jeśli jest to ramka główna.

    • processId

      liczba

      Identyfikator procesu, który uruchamia mechanizm renderowania dla tej ramki.

    • tabId

      liczba

      Identyfikator karty, na której następuje nawigacja.

    • timeStamp

      liczba

      Czas zatwierdzenia nawigacji w milisekundach od początku epoki.

    • transitionQualifiers

      TransitionQualifier[]

      Lista kwalifikatorów przejścia.

    • transitionType

      TransitionType

      Przyczyna nawigacji.

    • URL

      tekst

• filtry

  object opcjonalny

  • URL

    events.UrlFilter[]

    Warunki, które musi spełniać adres URL, do którego następuje przejście.

onTabReplaced

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

Uruchamiane, gdy zawartość karty zostanie zastąpiona inną kartą (zwykle wcześniej wyrenderowaną).

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (details: object) => void

  • szczegóły

    obiekt

    • replacedTabId

      liczba

      Identyfikator zastąpionej karty.

    • tabId

      liczba

      Identyfikator karty, która zastąpiła starą kartę.

    • timeStamp

      liczba

      Czas, kiedy nastąpiło zastąpienie, w milisekundach od początku epoki.