chrome.webNavigation

Opis

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

Uprawnienia

webNavigation

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ść wydarzeń

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

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

Każdy błąd, który wystąpi podczas tego procesu, powoduje zdarzenie onErrorOccurred. W przypadku konkretnej nawigacji po zdarzeniu onErrorOccurred nie są wywoływane żadne inne zdarzenia.

Jeśli ramka nawigacyjna zawiera ramki podrzędne, zdarzenie onCommitted jest wywoływane przed zdarzeniem onBeforeNavigate dowolnej z ramek podrzędnych, a zdarzenie onCompleted jest wywoływane po zdarzeniu onCompleted wszystkich ramek podrzędnych.

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

Jeśli interfejs History API 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 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, gdy strona została odwiedzona po raz pierwszy.

Jeśli nawigacja została wywołana za pomocą Chrome Instant lub Instant Pages, w bieżącej karcie następuje zamiana na całkowicie załadowaną stronę. W takim przypadku uruchamiane jest zdarzenie onTabReplaced.

Związek ze zdarzeniami webRequest

Nie ma określonej kolejności zdarzeń interfejsu webRequest API i zdarzeń interfejsu webNavigation API. Może się zdarzyć, że zdarzenia webRequest są nadal odbierane w przypadku ramek, które rozpoczęły już 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 niedostępny 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 w interfejsie API kart ani nie można o nie poprosić za pomocą webNavigation.getFrame lub webNavigation.getAllFrames. Gdy taka karta zostanie zamieniona, uruchamiane jest zdarzenie onTabReplaced i staje się ona dostępna za pomocą tych interfejsów API.

Sygnatury czasowe

Pamiętaj, że pewne techniczne osobliwości w sposobie obsługi przez system operacyjny odrębnych procesów Chrome mogą powodować rozbieżności między zegarem w samej przeglądarce a zegarem w procesach rozszerzeń. Oznacza to, że właściwość timeStamp zdarzeń WebNavigation jest wewnętrznie spójna. 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 identyfikować za pomocą identyfikatora ramki. Identyfikator ramki głównej to zawsze 0, a identyfikatory ramek podrzędnych to liczby dodatnie. Gdy dokument zostanie utworzony w ramce, jego identyfikator ramki pozostaje stały przez cały okres jego istnienia. Od 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 (tzn. dopóki nie zostanie wysłane zdarzenie onCommitted dla nowej głównej ramki). Innymi słowy, może istnieć więcej niż jedna oczekująca sekwencja zdarzeń webNavigation z tym samym frameId. Sekwencje można rozróżnić za pomocą klawisza processId.

Pamiętaj też, że podczas tymczasowego ładowania proces może być kilkakrotnie przełączany. 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 ostatecznego zdarzenia onCommitted.

Kolejną problematyczną kwestią w przypadku rozszerzeń jest cykl życia ramki. Ramka zawiera dokument (powiązany z zatwierdzonym adresem URL). Dokument może się zmieniać (np. w wyniku nawigacji), ale frameId nie, więc trudno jest powiązać zdarzenie w konkretnym dokumencie tylko z frameId. Wprowadzamy pojęcie documentId, czyli unikalnego identyfikatora dokumentu. Jeśli ramka zostanie przekierowana i otworzy nowy dokument, identyfikator ulegnie zmianie. To pole jest przydatne do określania, kiedy strony zmieniają stan cyklu życia (między wstępnym renderowaniem, aktywnością i pamięcią podręczną), ponieważ pozostaje niezmienione.

Typy i kwalifikatory przejść

Zdarzenie onCommitted interfejsu webNavigation API ma właściwości transitionType i transitionQualifiers. Typ przejścia jest taki sam jak w interfejsie history API i określa, jak przeglądarka przeszła do tego konkretnego adresu URL. Dodatkowo mogą być zwracane kwalifikatory przejścia, które dodatkowo definiują nawigację.

Istnieją te kwalifikatory przejścia:

Kwalifikacje do przejściaOpis
„client_redirect”Podczas nawigacji wystąpiło co najmniej jedno przekierowanie spowodowane przez tagi meta refresh lub JavaScript na stronie.
„server_redirect”Podczas nawigacji wystąpiło co najmniej jedno 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 rozpoczął 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 nowszy

Typ wyliczeniowy

"client_redirect"

„server_redirect”

„forward_back”

"from_address_bar"

TransitionType

Chrome 44 lub nowszy

Przyczyna nawigacji. Używane są te same typy przejść co w interfejsie History API. Są to te same typy przejść, które są zdefiniowane w interfejsie History API, z tym wyjątkiem, że zamiast "auto_toplevel" użyto "start_page" (dla zachowania zgodności wstecznej).

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

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (details?: object[]) => void

    • szczegóły

      object[] optional

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

      • documentId

        ciąg znaków

        Chrome 106 lub nowsza

        Identyfikator UUID wczytanego dokumentu.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • errorOccurred

        Wartość logiczna

        Wartość „true”, jeśli ostatnia nawigacja w tej ramce została przerwana przez błąd, tzn. zostało wywołane zdarzenie onErrorOccurred.

      • frameId

        liczba

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

      • frameType

        FrameType

        Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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 moduł renderujący dla tej ramki.

      • URL

        ciąg znaków

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

Zwroty

  • Promise<object[] | undefined>

    Chrome 93 lub nowszy

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getFrame()

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

Pobiera informacje o danej ramce. Ramka to element <iframe> lub <frame> strony internetowej. Jest identyfikowana za pomocą identyfikatora karty i identyfikatora ramki.

Parametry

  • szczegóły

    obiekt

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

    • documentId

      string opcjonalny

      Chrome 106 lub nowsza

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

    • frameId

      number opcjonalny

      Identyfikator ramki na danej karcie.

    • processId

      number opcjonalny

      Wycofane w Chrome 49

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

      Identyfikator procesu, który uruchamia moduł renderujący dla tej karty.

    • tabId

      number opcjonalny

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (details?: object) => void

    • szczegóły

      obiekt opcjonalny

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

      • documentId

        ciąg znaków

        Chrome 106 lub nowsza

        Identyfikator UUID wczytanego dokumentu.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • errorOccurred

        Wartość logiczna

        Wartość „true”, jeśli ostatnia nawigacja w tej ramce została przerwana przez błąd, tzn. zostało wywołane zdarzenie onErrorOccurred.

      • frameType

        FrameType

        Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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

        ciąg znaków

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

Zwroty

  • Promise<object | undefined>

    Chrome 93 lub nowszy

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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

      • Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • frameId

        liczba

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

      • Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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 w Chrome 50

        W przypadku tego zdarzenia nie jest już ustawiany identyfikator procesu, ponieważ proces, który będzie renderować wynikowy dokument, nie jest znany do momentu wywołania funkcji 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

        ciąg znaków

  • filtry

    obiekt opcjonalny

    • Warunki, które musi spełniać adres URL, do którego następuje nawigacja. Pola „schemes” i „ports” w UrlFilter są ignorowane w przypadku tego zdarzenia.

onCommitted

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

Uruchamiane po zatwierdzeniu nawigacji. Dokument (i zasoby, do których się odwołuje, np. obrazy i podramki) może być nadal pobierany, ale przynajmniej 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

        ciąg znaków

        Chrome 106 lub nowsza

        Identyfikator UUID wczytanego dokumentu.

      • Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • frameId

        liczba

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

      • Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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

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

      • processId

        liczba

        Identyfikator procesu, który uruchamia moduł renderujący dla tej ramki.

      • tabId

        liczba

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

      • timeStamp

        liczba

        Czas zatwierdzenia przejścia na stronę w milisekundach od początku epoki.

      • transitionQualifiers

        TransitionQualifier[]

        Lista kwalifikatorów przejścia.

      • transitionType

        TransitionType

        Przyczyna nawigacji.

      • URL

        ciąg znaków

  • filtry

    obiekt opcjonalny

    • Warunki, które musi spełniać adres URL, do którego następuje nawigacja. Pola „schemes” i „ports” w UrlFilter są ignorowane w przypadku tego zdarzenia.

onCompleted

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

Wysyłane, gdy dokument, w tym zasoby, do których się odwołuje, jest w pełni wczytany i zainicjowany.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • documentId

        ciąg znaków

        Chrome 106 lub nowsza

        Identyfikator UUID wczytanego dokumentu.

      • Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • frameId

        liczba

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

      • Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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

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

      • processId

        liczba

        Identyfikator procesu, który uruchamia moduł renderujący 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

        ciąg znaków

  • filtry

    obiekt opcjonalny

    • Warunki, które musi spełniać adres URL, do którego następuje nawigacja. Pola „schemes” i „ports” w UrlFilter są ignorowane w przypadku tego zdarzenia.

onCreatedNavigationTarget

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

Wysyłane, gdy do obsługi nawigacji zostanie utworzone nowe okno lub nowa karta w istniejącym oknie.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • sourceFrameId

        liczba

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

      • 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 otwierany jest adres URL.

      • timeStamp

        liczba

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

      • URL

        ciąg znaków

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

  • filtry

    obiekt opcjonalny

    • Warunki, które musi spełniać adres URL, do którego następuje nawigacja. Pola „schemes” i „ports” w UrlFilter są ignorowane w przypadku tego zdarzenia.

onDOMContentLoaded

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

Występuje, gdy DOM strony jest w pełni utworzony, ale zasoby, do których się odwołuje, mogą nie być jeszcze wczytane.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • documentId

        ciąg znaków

        Chrome 106 lub nowsza

        Identyfikator UUID wczytanego dokumentu.

      • Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • frameId

        liczba

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

      • Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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

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

      • processId

        liczba

        Identyfikator procesu, który uruchamia moduł renderujący dla tej ramki.

      • tabId

        liczba

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

      • timeStamp

        liczba

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

      • URL

        ciąg znaków

  • filtry

    obiekt opcjonalny

    • Warunki, które musi spełniać adres URL, do którego następuje nawigacja. Pola „schemes” i „ports” w UrlFilter są ignorowane w przypadku tego zdarzenia.

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

        ciąg znaków

        Chrome 106 lub nowsza

        Identyfikator UUID wczytanego dokumentu.

      • Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • błąd

        ciąg znaków

        Opis błędu.

      • frameId

        liczba

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

      • Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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

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

      • processId

        liczba

        Wycofane w Chrome 50

        W przypadku tego zdarzenia identyfikator procesu nie jest już ustawiony.

        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

        ciąg znaków

  • filtry

    obiekt opcjonalny

    • Warunki, które musi spełniać adres URL, do którego następuje nawigacja. Pola „schemes” i „ports” w UrlFilter są ignorowane w przypadku tego zdarzenia.

onHistoryStateUpdated

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

Wywoływane, gdy historia ramki została zaktualizowana do nowego adresu URL. Wszystkie przyszłe wydarzenia w tej ramce będą korzystać ze zaktualizowanego adresu URL.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • documentId

        ciąg znaków

        Chrome 106 lub nowsza

        Identyfikator UUID wczytanego dokumentu.

      • Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • frameId

        liczba

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

      • Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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

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

      • processId

        liczba

        Identyfikator procesu, który uruchamia moduł renderujący dla tej ramki.

      • tabId

        liczba

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

      • timeStamp

        liczba

        Czas zatwierdzenia przejścia na stronę w milisekundach od początku epoki.

      • transitionQualifiers

        TransitionQualifier[]

        Lista kwalifikatorów przejścia.

      • transitionType

        TransitionType

        Przyczyna nawigacji.

      • URL

        ciąg znaków

  • filtry

    obiekt opcjonalny

    • Warunki, które musi spełniać adres URL, do którego następuje nawigacja. Pola „schemes” i „ports” w UrlFilter są ignorowane w przypadku tego zdarzenia.

onReferenceFragmentUpdated

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

Uruchamiane po zaktualizowaniu fragmentu referencyjnego klatki. Wszystkie przyszłe wydarzenia w tej ramce będą korzystać ze zaktualizowanego adresu URL.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • documentId

        ciąg znaków

        Chrome 106 lub nowsza

        Identyfikator UUID wczytanego dokumentu.

      • Chrome 106 lub nowsza

        Cykl życia dokumentu.

      • frameId

        liczba

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

      • Chrome 106 lub nowsza

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

      • parentDocumentId

        string opcjonalny

        Chrome 106 lub nowsza

        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

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

      • processId

        liczba

        Identyfikator procesu, który uruchamia moduł renderujący dla tej ramki.

      • tabId

        liczba

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

      • timeStamp

        liczba

        Czas zatwierdzenia przejścia na stronę w milisekundach od początku epoki.

      • transitionQualifiers

        TransitionQualifier[]

        Lista kwalifikatorów przejścia.

      • transitionType

        TransitionType

        Przyczyna nawigacji.

      • URL

        ciąg znaków

  • filtry

    obiekt opcjonalny

    • Warunki, które musi spełniać adres URL, do którego następuje nawigacja. Pola „schemes” i „ports” w UrlFilter są ignorowane w przypadku tego zdarzenia.

onTabReplaced

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

Wywoływane, gdy zawartość karty zostanie zastąpiona inną kartą (zwykle wcześniej wstępnie wyrenderowaną).

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void

    • szczegóły

      obiekt

      • replacedTabId

        liczba

        Identyfikator karty, która została zastąpiona.

      • tabId

        liczba

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

      • timeStamp

        liczba

        Czas, w którym nastąpiła zamiana, w milisekundach od początku epoki.