chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

Opis

Interfejs chrome.extensionTypes API zawiera deklaracje typów rozszerzeń do 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 87 lub nowsza

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 wartość parametru allFrames to 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 jest usuwany z wybranej ramki i wszystkich jej ramek podrzędnych.

• kod

  ciąg znaków opcjonalny

  Kod CSS do usunięcia.

• cssOrigin

  CSSOrigin opcjonalne

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

• plik

  ciąg znaków opcjonalny

  plik CSS do usunięcia.

• frameId

  number opcjonalny

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

• matchAboutBlank

  wartość logiczna opcjonalna

  Jeśli parametr 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

• format

  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 na obrazie pojawia się więcej artefaktów wizualnych, a liczba bajtów potrzebnych do jego zapisania maleje.

ImageFormat

Chrome 44 lub nowsza

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 on wstawiany 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

  ciąg znaków opcjonalny

  Kod JavaScript lub CSS do wstrzyknięcia.

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

• cssOrigin

  CSSOrigin opcjonalne

  Chrome 66 lub nowsza

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

• plik

  ciąg znaków opcjonalny

  Plik JavaScript lub CSS do wstrzyknięcia.

• frameId

  number opcjonalny

  Chrome 50 lub nowsza

  Ramka, w której ma zostać wstrzyknięty skrypt lub 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 nowsza

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 jakiegokolwiek 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 wywołaniu zdarzenia window.onload. Dokładny moment wstawienia zależy od złożoności dokumentu i czasu jego wczytywania. Jest on zoptymalizowany pod kątem szybkości wczytywania strony. Skrypty treści działające w stanie „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 window.onload, rozszerzenie może sprawdzić, czy zdarzenie onload zostało już wywołane, za pomocą właściwości document.readyState.