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