chrome.extensionTypes

дата обновления: 2026-09-25 robots: noindex

Описание

API chrome.extensionTypes содержит объявления типов для расширений Chrome.

Типы

ColorArray

Chrome 139+

Тип

[число, число, число, число]

CSSOrigin

Chrome 66+

Происхождение внедренного CSS.

Перечисление

«автор»

"пользователь"

DeleteInjectionDetails

Chrome 87+

Подробности о CSS-коде, который нужно удалить. Необходимо указать либо код, либо свойство файла, но одновременно нельзя указывать и то, и другое.

Характеристики

  • все кадры

    логический необязательный

    Если allFrames равно true , это означает, что CSS-код должен быть удален из всех фреймов текущей страницы. По умолчанию значение равно false , и код удаляется только из верхнего фрейма. Если true и задан frameId , то код удаляется из выбранного фрейма и всех его дочерних фреймов.

  • код

    строка необязательный

    CSS-код для удаления.

  • cssOrigin

    CSSOrigin необязателен

    Источник CSS-кода, который нужно удалить. По умолчанию — "author" .

  • файл

    строка необязательный

    CSS-файл для удаления.

  • frameId

    число необязательно

    Фрейм , из которого следует удалить CSS-код. По умолчанию — 0 (фрейм верхнего уровня).

  • matchAboutBlank

    логический необязательный

    Если matchAboutBlank имеет значение true, то код также удаляется из фреймов about:blank и about:srcdoc, если ваше расширение имеет доступ к родительскому документу. По умолчанию оно имеет false .

DocumentLifecycle

Chrome 106+

Жизненный цикл документа в рамках данного фрейма.

Перечисление

"пререндеринг"

"активный"

"кэшированный"

"pending_deletion"

ExecutionWorld

Chrome 111+

Окружение JavaScript, в котором будет выполняться скрипт. Это может быть изолированное окружение, уникальное для данного расширения, основное окружение DOM, которое используется совместно с JavaScript страницы, или окружение пользовательских скриптов, доступное только для скриптов, зарегистрированных в API пользовательских скриптов.

Перечисление

"ИЗОЛИРОВАННЫЙ"

"ОСНОВНОЙ"

"USER_SCRIPT"

FrameType

Chrome 106+

Тип рамы.

Перечисление

"outermost_frame"

"огражденная_рама"

"sub_frame"

ImageDataType

Chrome 139+

Пиксельные данные изображения. Должны быть объектом ImageData; например, из элемента canvas .

Тип

ImageData

ImageDetails

Подробная информация о формате, качестве и площади изображения.

Характеристики

  • формат

    ImageFormat ( необязательно)

    Формат получаемого изображения. По умолчанию — "jpeg" .

  • качество

    число необязательно

    Если формат установлен на "jpeg" , это значение управляет качеством результирующего изображения. Для изображений в формате PNG это значение игнорируется. По мере снижения качества результирующее изображение будет содержать больше визуальных артефактов, а количество байтов, необходимых для его хранения, уменьшится.

ImageFormat

Chrome 44+

Формат изображения.

Перечисление

"jpeg"

"png"

InjectDetails

Детали скрипта или CSS-кода для внедрения. Необходимо указать либо код, либо свойство файла, но одновременно нельзя указывать и то, и другое.

Характеристики

  • все кадры

    логический необязательный

    Если allFrames равно true , это означает, что JavaScript или CSS должен быть внедрен во все фреймы текущей страницы. По умолчанию это значение false , и код внедряется только в верхний фрейм. Если true и задан frameId , то код вставляется в выбранный фрейм и все его дочерние фреймы.

  • код

    строка необязательный

    Для внедрения используйте JavaScript или CSS-код.

    Внимание: Будьте осторожны при использовании параметра code . Неправильное его использование может сделать ваше расширение уязвимым для атак межсайтового скриптинга (XSS).

  • cssOrigin

    CSSOrigin необязателен

    Chrome 66+

    Источник CSS-кода для внедрения. Этот параметр можно указать только для CSS, а не для JavaScript. По умолчанию используется значение "author" .

  • файл

    строка необязательный

    Для внедрения используйте JavaScript-код или CSS-файл.

  • frameId

    число необязательно

    Chrome 50+

    Фрейм , куда следует внедрить скрипт или CSS. По умолчанию — 0 (фрейм верхнего уровня).

  • matchAboutBlank

    логический необязательный

    Если matchAboutBlank имеет значение true, то код также внедряется в фреймы about:blank и about:srcdoc, если ваше расширение имеет доступ к родительскому документу. Код не может быть вставлен в фреймы верхнего уровня about:-frames. По умолчанию значение равно false .

  • runAt

    RunAt optional

    Самое раннее время, когда JavaScript или CSS будут внедрены во вкладку. По умолчанию используется значение "document_idle".

RunAt

Chrome 44+

Как только JavaScript или CSS будут внедрены во вкладку, это произойдёт в ближайшее время.

Перечисление

"document_start"
Скрипт внедряется после любых файлов CSS, но до того, как будет создан какой-либо другой DOM-элемент или запущен какой-либо другой скрипт.

"document_end"
Скрипт внедряется сразу после завершения формирования DOM-дерева, но до загрузки таких вложенных ресурсов, как изображения и фреймы.

"document_idle"
Браузер выбирает момент для внедрения скрипта между событием "document_end" и моментом сразу после срабатывания события window.onload . Точный момент внедрения зависит от сложности документа и времени его загрузки, и оптимизирован для скорости загрузки страницы. Скрипты содержимого, работающие в состоянии "document_idle", не обязаны отслеживать событие window.onload ; гарантируется, что они будут выполнены после завершения обработки DOM. Если скрипту определенно необходимо выполниться после window.onload , расширение может проверить, сработало ли onload используя свойство document.readyState .