chrome.extensionTypes

Opis

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

Typy

ColorArray

Chrome 139 lub nowsza

Typ

[liczba, liczba, liczba, liczba]

CSSOrigin

Chrome 66 lub nowsza

Pochodzenie wstrzykniętego kodu CSS.

Typ wyliczeniowy

„author”

„user”

DeleteInjectionDetails

Chrome w wersji 87 lub nowszej

Szczegóły usługi porównywania cen do usunięcia. Musisz ustawić właściwość kodu lub pliku, ale nie możesz ustawić obu jednocześnie.

Właściwości

  • allFrames

    wartość logiczna opcjonalna

    Jeśli parametr 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 górnej ramki. Jeśli ustawione są wartości true i frameId, kod zostanie usunięty z wybranej ramki i wszystkich jej ramek podrzędnych.

  • kod

    string opcjonalny

    Kod CSS do usunięcia.

  • cssOrigin

    CSSOrigin opcjonalny

    Pochodzenie kodu CSS do usunięcia. Domyślna wartość to "author".

  • plik

    string opcjonalny

    plik CSS do usunięcia.

  • frameId

    number 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 matchAboutBlank ma wartość true, kod jest też usuwany z ramek about:blank i about:srcdoc, jeśli rozszerzenie ma dostęp do dokumentu nadrzędnego. Domyślnie jest to false.

DocumentLifecycle

Chrome 106 lub nowsza

Cykl życia dokumentu ramki.

Typ wyliczeniowy

„prerender”

„aktywny”

„cached”

„pending_deletion”

ExecutionWorld

Chrome 111 lub nowsza

Środowisko JavaScript, w którym ma być wykonywany skrypt. Może to być odizolowany świat unikalny dla tego rozszerzenia, główny świat DOM, który jest współdzielony z JavaScriptem strony, lub świat skryptów użytkownika, który jest dostępny tylko dla skryptów zarejestrowanych w interfejsie User Scripts API.

Typ wyliczeniowy

„ISOLATED”

„MAIN”

„USER_SCRIPT”

FrameType

Chrome 106 lub nowsza

Typ ramki.

Typ wyliczeniowy

„outermost_frame”

„fenced_frame”

„sub_frame”

ImageDataType

Chrome 139 lub nowsza

Dane pikseli obrazu. Musi to być obiekt ImageData, np. z elementu canvas.

Typ

ImageData

ImageDetails

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

Właściwości

  • reklamy

    ImageFormat opcjonalny

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

  • jakość

    number opcjonalny

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

ImageFormat

Chrome 44 lub nowszy

Format obrazu.

Typ wyliczeniowy

"jpeg"

„png”

InjectDetails

Szczegóły skryptu lub kodu CSS do wstrzyknięcia. Musisz ustawić właściwość kodu lub pliku, ale nie możesz ustawić obu jednocześnie.

Właściwości

  • allFrames

    wartość logiczna opcjonalna

    Jeśli wartość allFrames to 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 ramki najwyższego poziomu. Jeśli ustawione są wartości true i frameId, kod jest wstawiany w wybranej ramce i we wszystkich jej ramkach podrzędnych.

  • kod

    string opcjonalny

    Kod JavaScript lub CSS do wstrzyknięcia.

    Ostrzeżenie: zachowaj ostrożność podczas korzystania z parametru code. Nieprawidłowe użycie może narazić rozszerzenie na ataki typu cross-site scripting.

  • cssOrigin

    CSSOrigin opcjonalny

    Chrome 66 lub nowsza

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

  • plik

    string opcjonalny

    Plik JavaScript lub CSS do wstrzyknięcia.

  • frameId

    number opcjonalny

    Chrome w wersji 50 lub nowszej

    Ramka, w 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 matchAboutBlank ma wartość true, kod jest też wstrzykiwany w ramkach about:blank i about:srcdoc, jeśli rozszerzenie ma dostęp do dokumentu nadrzędnego. Kodu nie można wstawić w ramkach najwyższego poziomu about: Domyślnie jest to false.

  • runAt

    RunAt opcjonalny

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

RunAt

Chrome 44 lub nowszy

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

Typ wyliczeniowy

„document_start”
Skrypt jest wstrzykiwany po wszystkich plikach CSS, ale przed utworzeniem jakiegokolwiek innego elementu DOM lub uruchomieniem innego skryptu.

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

„document_idle”
Przeglądarka wybiera czas na wstrzyknięcie skryptu między „document_end” a momentem bezpośrednio po uruchomieniu zdarzenia window.onload. Dokładny moment wstawienia 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 działające w momencie „document_idle” nie muszą nasłuchiwać zdarzenia window.onload. Gwarantujemy, że zostaną uruchomione po zakończeniu działania DOM. Jeśli skrypt musi być uruchomiony po zdarzeniu window.onload, rozszerzenie może sprawdzić, czy zdarzenie onload zostało już wywołane, za pomocą właściwości document.readyState.