chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

Opis

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

Typy

ColorArray

Chrome 139 lub nowsza wersja

Typ

[number, number, number, number]

CSSOrigin

Chrome 66 lub nowsza wersja

Źródło wstrzykniętego kodu CSS.

Typ wyliczeniowy

"author"

"user"

DeleteInjectionDetails

Chrome 87 lub nowsza wersja

Szczegóły usługi porównywania cen, którą chcesz usunąć. Należy ustawić właściwość kodu lub pliku, ale nie można ustawić obu jednocześnie.

Właściwości

• allFrames

  boolean opcjonalne

  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ą parametry 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

  Źródło kodu CSS do usunięcia. Domyślna wartość to "author".

• plik

  ciąg znaków opcjonalny

  Plik CSS do usunięcia.

• frameId

  number optional

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

• matchAboutBlank

  boolean opcjonalne

  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ślna wartość to false.

DocumentLifecycle

Chrome 106 lub nowsza wersja

Cykl życia dokumentu ramki.

Typ wyliczeniowy

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 lub nowsza wersja

Środowisko JavaScript, w którym ma zostać wykonany skrypt. Może to być odizolowane środowisko unikalne dla tego rozszerzenia, główne środowisko DOM, które jest udostępniane skryptom JavaScript strony, lub środowisko skryptów użytkownika, które jest dostępne tylko dla skryptów zarejestrowanych za pomocą interfejsu User Scripts API.

Typ wyliczeniowy

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 lub nowsza wersja

Typ ramki.

Typ wyliczeniowy

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 lub nowsza wersja

Dane pikseli obrazu. Musi to być obiekt ImageData, na przykład 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 optional

  Gdy format to "jpeg", kontroluje jakość obrazu wynikowego. Ta wartość jest ignorowana w przypadku obrazów PNG. W miarę obniżania 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 nowsza wersja

Format obrazu.

Typ wyliczeniowy

"jpeg"

"png"

InjectDetails

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

Właściwości

• allFrames

  boolean opcjonalne

  Jeśli parametr 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 ustawione są parametry true i frameId, kod jest wstawiany 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 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 wersja

  Źródło kodu CSS do wstrzyknięcia. Można to 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 optional

  Chrome 50 lub nowsza wersja

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

• matchAboutBlank

  boolean opcjonalne

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

• runAt

  RunAt opcjonalny

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

RunAt

Chrome 44 lub nowsza wersja

Najwcześniejszy moment, w którym JavaScript lub CSS zostaną wstrzyknięte do karty.

Typ wyliczeniowy

"document_start"
Skrypt jest wstrzykiwany po plikach CSS, ale przed utworzeniem innych elementów DOM lub uruchomieniem innych skryptów.

"document_end"
Skrypt jest wstrzykiwany natychmiast po zakończeniu modelu 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 tuż po wywołaniu 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 trybie „document_idle” nie muszą nasłuchiwać zdarzenia window.onload. Na pewno zostaną uruchomione po zakończeniu działania DOM. Jeśli skrypt musi zostać uruchomiony po zdarzeniu window.onload, rozszerzenie może sprawdzić, czy zdarzenie onload zostało już wywołane, używając właściwości document.readyState.