Описание
API chrome.extensionTypes
содержит объявления типов для расширений Chrome.
Типы
ColorArray
Тип
[число, число, число, число]
Перечисление
"автор" "пользователь"
DeleteInjectionDetails
Подробности CSS для удаления. Необходимо задать либо код, либо свойство файла, но оба они не могут быть заданы одновременно.
Характеристики
- всеРамки
булев необязательный
Если allFrames имеет значение
true
, подразумевает, что CSS следует удалить из всех фреймов текущей страницы. По умолчанию это значениеfalse
и удаляется только из верхнего фрейма. Еслиtrue
и заданframeId
, то код удаляется из выбранного фрейма и всех его дочерних фреймов. - код
строка необязательная
CSS-код для удаления.
- cssOrigin
CSSOrigin необязательный
Источник CSS для удаления. По умолчанию
"author"
. - файл
строка необязательная
Файл CSS для удаления.
- frameId
номер необязательный
Кадр , из которого следует удалить CSS. По умолчанию 0 (кадр верхнего уровня).
- matchО насБланк
булев необязательный
Если matchAboutBlank имеет значение true, то код также удаляется из фреймов about:blank и about:srcdoc, если ваше расширение имеет доступ к своему родительскому документу. По умолчанию это
false
.
DocumentLifecycle
Жизненный цикл документа фрейма.
Перечисление
"пререндер" "активный" "кэшированный" "ожидание_удаления"
ExecutionWorld
Мир JavaScript для выполнения скрипта внутри. Может быть изолированным миром, уникальным для этого расширения, основным миром DOM, который используется совместно с JavaScript страницы, или миром пользовательских скриптов, который доступен только для скриптов, зарегистрированных с помощью API пользовательских скриптов.
Перечисление
«ИЗОЛИРОВАННЫЙ» "ОСНОВНОЙ" "USER_SCRIPT"
FrameType
Тип рамы.
Перечисление
"внешний_кадр" "огороженная_рама" "подкадр"
ImageDataType
Данные пикселей для изображения. Должен быть объектом ImageData; например, из элемента canvas
.
Тип
ImageData
ImageDetails
Подробная информация о формате и качестве изображения.
Характеристики
- формат
Формат изображения необязательный
Формат результирующего изображения. По умолчанию
"jpeg"
. - качество
номер необязательный
Если формат —
"jpeg"
, управляет качеством результирующего изображения. Это значение игнорируется для изображений PNG. По мере снижения качества результирующее изображение будет иметь больше визуальных артефактов, а количество байтов, необходимых для его хранения, уменьшится.
ImageFormat
Формат изображения.
Перечисление
"jpeg" "png"
InjectDetails
Подробности скрипта или CSS для внедрения. Необходимо задать либо код, либо свойство файла, но оба они не могут быть заданы одновременно.
Характеристики
- всеРамки
булев необязательный
Если allFrames имеет значение
true
, подразумевается, что JavaScript или CSS должны быть внедрены во все фреймы текущей страницы. По умолчанию это значениеfalse
и внедряется только в верхний фрейм. Еслиtrue
и заданframeId
, то код вставляется в выбранный фрейм и все его дочерние фреймы. - код
строка необязательная
Код JavaScript или CSS для внедрения.
Предупреждение: Будьте осторожны, используя параметр
code
. Неправильное его использование может открыть ваше расширение для атак с использованием межсайтового скриптинга - cssOrigin
CSSOrigin необязательный
Хром 66+Источник CSS для внедрения. Может быть указан только для CSS, но не для JavaScript. По умолчанию
"author"
. - файл
строка необязательная
Файл JavaScript или CSS для внедрения.
- frameId
номер необязательный
Хром 50+Кадр , в который должен быть вставлен скрипт или CSS. По умолчанию 0 (кадр верхнего уровня).
- matchО насБланк
булев необязательный
Если matchAboutBlank имеет значение true, то код также внедряется в фреймы about:blank и about:srcdoc, если у вашего расширения есть доступ к его родительскому документу. Код не может быть вставлен в фреймы about:-top-level. По умолчанию это
false
. - runAt
RunAt необязательно
Самое ближайшее время, когда JavaScript или CSS будут внедрены во вкладку. По умолчанию "document_idle".
RunAt
Как можно скорее JavaScript или CSS будут внедрены во вкладку.
Перечисление
"document_start" "document_end" "document_idle"
Скрипт внедряется после любых файлов из css, но до построения любого другого DOM или запуска любого другого скрипта.
Скрипт внедряется сразу после завершения DOM, но до загрузки подресурсов, таких как изображения и фреймы.
Браузер выбирает время для внедрения скрипта между "document_end" и сразу после срабатывания события window.onload
. Точный момент внедрения зависит от сложности документа и времени его загрузки, а также оптимизируется для скорости загрузки страницы. Скрипты контента, работающие в "document_idle", не должны прослушивать событие window.onload
; они гарантированно запустятся после завершения DOM. Если скрипт определенно должен запуститься после window.onload
, расширение может проверить, сработало ли onload
с помощью свойства document.readyState
.