chrome.extensionTypes

Opis

Interfejs API chrome.extensionTypes zawiera deklaracje typów dla rozszerzeń Chrome.

Typy

ColorArray

Oczekuje

Typ

[liczba, liczba, liczba, liczba]

CSSOrigin

Chrome 66 lub nowszy

Pochodzenie wstrzykniętego kodu CSS.

Typ wyliczeniowy

„author”

„user”

DeleteInjectionDetails

Chrome 87 lub nowszy

Szczegóły usługi porównywania cen, którą chcesz usunąć. Musisz ustawić kod lub plik, ale nie możesz ustawić obu naraz.

Właściwości

  • allFrames

    wartość logiczna opcjonalna

    Jeśli allFrames ma wartość true, oznacza to, że kod CSS powinien zostać usunięty ze wszystkich ramek bieżącej strony. Domyślnie jest to false i jest usuwany tylko z ramki górnej. Jeśli ustawisz true i frameId, kod zostanie usunięty z wybranego kadru i wszystkich jego podrzędnych.

  • kod

    string opcjonalny

    Kod CSS do usunięcia.

  • cssOrigin

    CSSOrigin opcjonalnie

    Pochodzenie kodu CSS, który ma zostać usunięty. Domyślna wartość to "author".

  • plik

    string opcjonalny

    Plik CSS do usunięcia.

  • frameId

    numer opcjonalny

    Ramka, z której należy usunąć kod CSS. Domyślna wartość to 0 (ramka najwyższego poziomu).

  • matchAboutBlank

    wartość logiczna opcjonalna

    Jeśli wartość parametru matchAboutBlank to prawda, kod jest również usuwany z ramek about:blank i about:srcdoc, jeśli Twoje rozszerzenie ma dostęp do dokumentu nadrzędnego. Domyślnie jest to false.

DocumentLifecycle

Chrome w wersji 106 lub nowszej

Cykl życia dokumentu w ramach projektu.

Typ wyliczeniowy

„prerender”

„active”

„w pamięci podręcznej”

"pending_deletion"

ExecutionWorld

Chrome 111 lub nowszy

Środowisko JavaScript, w którym ma działać skrypt. Może to być świat izolowany, niepowtarzalny dla tego rozszerzenia, główny świat DOM współdzielony z JavaScriptem strony lub świat skryptów użytkownika dostępny tylko dla skryptów zarejestrowanych za pomocą interfejsu User Scripts API.

Typ wyliczeniowy

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome w wersji 106 lub nowszej

Typ ramki.

Typ wyliczeniowy

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Oczekuje

Dane pikseli obrazu. Musi być obiektem ImageData, na przykład z elementu canvas.

Typ

ImageData

ImageDetails

Szczegóły dotyczące formatu i jakości obrazu.

Właściwości

  • reklamy

    ImageFormat opcjonalny

    Format wynikowego obrazu. Wartość domyślna to "jpeg".

  • jakość

    numer opcjonalny

    Gdy format to "jpeg", określa jakość uzyskanego obrazu. Ta wartość jest ignorowana w przypadku obrazów PNG. Wraz ze spadkiem jakości obraz będzie zawierał więcej artefaktów wizualnych, a liczba bajtów potrzebnych do jego przechowywania będzie się zmniejszać.

ImageFormat

Chrome 44 lub nowszy

Format obrazu.

Typ wyliczeniowy

„jpeg”

„png”

InjectDetails

Szczegóły skryptu lub kodu CSS, który chcesz wstrzyknąć. Musisz ustawić kod lub plik, ale nie możesz ustawić obu naraz.

Właściwości

  • allFrames

    wartość logiczna opcjonalna

    Jeśli allFrames ma wartość true, oznacza to, że kod JavaScript lub CSS powinien zostać wstrzyknięty do wszystkich ramek bieżącej strony. Domyślnie jest to false i jest wstrzykiwany tylko do górnej ramki. Jeśli ustawisz true i frameId, kod zostanie wstawiony w wybranym ujęciu i wszystkich jego podrzędnych ujęciach.

  • kod

    string opcjonalny

    kod JavaScript lub CSS, który chcesz wstrzyknąć.

    Ostrzeżenie: używaj parametru code z uwagą. Nieprawidłowe użycie może narazić rozszerzenie na ataki cross-site scripting

  • cssOrigin

    CSSOrigin opcjonalnie

    Chrome 66 lub nowszy

    Pochodzenie kodu CSS do wstrzyknięcia. Można go określić tylko w przypadku CSS, a nie JavaScriptu. Domyślna wartość to "author".

  • plik

    string opcjonalny

    Plik JavaScript lub CSS, który chcesz wstrzyknąć.

  • frameId

    numer opcjonalny

    Chrome 50+

    Ramka, do której ma zostać wstrzyknięty skrypt lub kod CSS. Domyślna wartość to 0 (ramka najwyższego poziomu).

  • matchAboutBlank

    wartość logiczna opcjonalna

    Jeśli wartość parametru matchAboutBlank jest równa true, kod jest również wstrzykiwany do ramek about:blank i about:srcdoc, jeśli Twoje rozszerzenie ma dostęp do dokumentu nadrzędnego. Kodu nie można wstawiać w ramkach na najwyższym poziomie. Domyślnie jest to false.

  • runAt

    RunAt opcjonalny

    Najwcześniejszy termin, w którym kod JavaScript lub CSS zostanie wstrzyknięty do karty. Wartość domyślna to „document_idle”.

RunAt

Chrome 44 lub nowszy

Najwcześniejszy termin, w którym kod JavaScript lub CSS zostanie wstrzyknięty do karty.

Typ wyliczeniowy

"document_start"
Skrypt jest wstrzykiwany po dowolnych plikach z css, ale przed utworzeniem innego elementu DOM lub uruchomieniem innego skryptu.

"document_end"
Skrypt jest wstrzykiwany natychmiast po zakończeniu tworzenia DOM, ale przed załadowaniem zasobów podrzędnych, takich jak obrazy i ramki.

"document_idle"
Przeglądarka wybiera moment wstrzyknięcia skryptu między zdarzeniem „document_end” a natychmiast po wystąpieniu zdarzenia window.onload. Dokładny moment wstrzyknięcia zależy od złożoności dokumentu i czasu jego wczytywania. Jest on optymalizowany pod kątem szybkości wczytywania strony. Skrypty treści uruchamiane w ramach „document_idle” nie muszą nasłuchiwać zdarzenia window.onload; są one zawsze uruchamiane po zakończeniu działania DOM. Jeśli skrypt musi działać dopiero po wywołaniu window.onload, rozszerzenie może sprawdzić, czy onload zostało już wywołane, korzystając z właściwości document.readyState.