chrome.extensionTypes

Описание

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

Типы

ColorArray

Хром 139+

Тип

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

CSSOrigin

Хром 66+

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

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

"автор"

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

DeleteInjectionDetails

Хром 87+

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

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

  • allFrames

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

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

  • код

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

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

  • cssOrigin

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

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

  • файл

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

    Файл CSS для удаления.

  • frameId

    номер необязательно

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

  • matchAboutBlank

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

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

DocumentLifecycle

Хром 106+

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

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

"пререндер"

"активный"

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

"pending_deletion"

ExecutionWorld

Хром 111+

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

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

«ИЗОЛИРОВАННЫЙ»

"ОСНОВНОЙ"

"USER_SCRIPT"

FrameType

Хром 106+

Тип рамы.

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

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Хром 139+

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

Тип

ImageData

ImageDetails

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

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

  • формат

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

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

  • качество

    номер необязательно

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

ImageFormat

Хром 44+

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

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

"jpeg"

"png"

InjectDetails

Подробная информация о скрипте или CSS для внедрения. Необходимо задать либо код, либо свойство файла, но оба одновременно задать нельзя.

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

  • allFrames

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

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

  • код

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

    Код JavaScript или CSS для внедрения.

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

  • cssOrigin

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

    Хром 66+

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

  • файл

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

    Файл JavaScript или CSS для внедрения.

  • frameId

    номер необязательно

    Хром 50+

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

  • matchAboutBlank

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

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

  • runAt

    RunAt необязательно

    Как только JavaScript или CSS будут добавлены во вкладку. Значение по умолчанию — «document_idle».

RunAt

Хром 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 .