chrome.extensionTypes

Opis

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

Typy

CSSOrigin

Chrome 66 i nowsze wersje

Pochodzenie wstrzykniętego kodu CSS.

Typ wyliczeniowy

DeleteInjectionDetails

Chrome 87 i nowsze wersje

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

Właściwości

  • allFrames

    wartość logiczna opcjonalna

    Jeśli parametr allFrame ma wartość true, kod CSS powinien zostać usunięty ze wszystkich ramek bieżącej strony. Domyślnie jest to false i jest usuwane tylko z górnej ramki. Jeśli skonfigurowano true i frameId, kod jest usuwany z wybranej ramki i wszystkich jej ramek podrzędnych.

  • kod

    ciąg znaków opcjonalny

    Kod CSS do usunięcia.

  • cssOrigin

    Opcjonalny CSSOrigin

    Pochodzenie usługi porównywania cen do usunięcia. Domyślna wartość to "author".

  • plik

    ciąg znaków opcjonalny

    plik CSS do usunięcia.

  • frameId

    Liczba opcjonalnie

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

  • matchAboutBlank

    wartość logiczna opcjonalna

    Jeśli parametr matchAboutBlank ma wartość true (prawda), kod jest też usuwany z ramek about:blank i about:srcdoc, jeśli rozszerzenie ma dostęp do swojego dokumentu nadrzędnego. Domyślnie jest to false.

DocumentLifecycle

Chrome 106 i nowsze wersje

Cykl życia ramki dokumentu.

Typ wyliczeniowy

ExecutionWorld

Chrome 111 i nowsze wersje

Świat JavaScriptu, w którym ma być wykonywany skrypt. Może to być odizolowany świat unikalny dla tego rozszerzenia, główny świat DOM udostępniany przez kod JavaScript strony lub świat skryptów użytkownika dostępny tylko dla skryptów zarejestrowanych przy użyciu interfejsu User Scripts API.

Typ wyliczeniowy

FrameType

Chrome 106 i nowsze wersje

Typ ramki.

Typ wyliczeniowy

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDetails

Szczegółowe informacje o formacie i jakości obrazu.

Właściwości

  • reklamy

    ImageFormat (opcjonalny)

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

  • jakość

    Liczba opcjonalnie

    Jeśli format to "jpeg", określa jakość obrazu. Ta wartość jest ignorowana w przypadku obrazów PNG. W miarę pogorszenia jakości na wynikowym obrazie będzie więcej artefaktów wizualnych, a liczba bajtów do jego zapisania się zmniejszy.

ImageFormat

Chrome 44 i nowsze wersje

Format obrazu.

Typ wyliczeniowy

InjectDetails

Szczegóły skryptu lub arkusza CSS do wstrzyknięcia. Musisz ustawić kod lub właściwość pliku, ale nie można ustawić obu tych elementów jednocześnie.

Właściwości

  • allFrames

    wartość logiczna opcjonalna

    Jeśli parametr allFrames ma wartość true, oznacza to, że JavaScript lub CSS powinien być wstrzyknięty we wszystkich ramkach na bieżącej stronie. Domyślnie jest to false i jest wstrzykiwany tylko w górnej ramce. Jeśli ustawione są true i frameId, kod jest wstawiony w wybranej ramce i wszystkich jej ramkach podrzędnych.

  • kod

    ciąg znaków opcjonalny

    Kod JavaScript lub CSS do wstrzyknięcia.

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

  • cssOrigin

    Opcjonalny CSSOrigin

    Chrome 66 i nowsze wersje

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

  • plik

    ciąg znaków opcjonalny

    Plik JavaScript lub CSS do wstrzyknięcia.

  • frameId

    Liczba opcjonalnie

    Chrome 50 i nowsze wersje

    Ramka, w której należy wstawić skrypt lub CSS. Domyślna wartość to 0 (ramka najwyższego poziomu).

  • matchAboutBlank

    wartość logiczna opcjonalna

    Jeśli parametr matchAboutBlank ma wartość true, kod jest też wstrzykiwany w ramkach about:blank i about:srcdoc, jeśli rozszerzenie ma dostęp do swojego dokumentu nadrzędnego. Nie można wstawić kodu o:-frames najwyższego poziomu. Domyślnie jest to false.

  • runAt

    RunAt opcjonalnie

    Kod JavaScript lub CSS zostanie wstawiony na karcie najszybciej. Wartość domyślna to „document_idle”.

RunAt

Chrome 44 i nowsze wersje

Kod JavaScript lub CSS zostanie wstawiony na karcie najszybciej.

Typ wyliczeniowy

"document_start"
Skrypt jest wstrzykiwany po plikach z CSS, ale przed utworzeniem innego modelu DOM lub uruchomieniem jakiegokolwiek innego skryptu.

"document_end"
Skrypt jest wstrzykiwany bezpośrednio po zakończeniu modelu DOM, ale przed wczytaniem zasobów podrzędnych, takich jak obrazy czy ramki.

"document_idle"
Przeglądarka wybiera, kiedy ma wstawić skrypt między „document_end” a natychmiast po uruchomieniu zdarzenia window.onload. Dokładny moment wstrzyknięcia zależy od złożoności dokumentu i czasu potrzebnego na jego wczytanie. Jest zoptymalizowany pod kątem szybkości wczytywania strony. Skrypty treści działające z parametrem „document_idle” nie muszą nasłuchiwać zdarzenia window.onload. Skrypty na pewno będą działać po zakończeniu działania DOM. Jeśli skrypt musi zostać uruchomiony po window.onload, rozszerzenie może za pomocą właściwości document.readyState sprawdzić, czy został już uruchomiony skrypt onload.