Бөлісу құралы:

Поддерживаемые API для расширений Microsoft Edge

  • Мақала

Расширения Microsoft Edge используют подмножество методов JavaScript для платформы подсистемы браузера Chromium. При создании расширения для браузера Microsoft Edge можно использовать следующие API.

API Описание Версии манифеста
accessibilityFeatures Управляет специальными возможностями браузера. MV2, MV3
action Управляет значком расширения на панели инструментов браузера. MV3
Сигнализации Планирует выполнение кода периодически или в указанное время в будущем. MV2, MV3
Закладки Создает закладки, упорядочивает их и управляет ими. MV2, MV3
browserAction Использует действия браузера для размещения значков на панели инструментов в Microsoft Edge. Вы также можете использовать действия браузера, чтобы добавить подсказку, эмблему или всплывающее окно. MV2
просмотр данных Удаляет данные браузера из локального профиля пользователя. MV2, MV3
Команды Добавляет сочетания клавиш, которые активируют действия в расширении, например действие для открытия браузера или отправки команды расширению. MV2, MV3
contentSettings Настраивает поведение Microsoft Edge на каждом сайте, а не глобально. Изменяет параметры, определяющие, могут ли веб-сайты использовать такие функции, как файлы cookie, JavaScript и подключаемые модули. MV2, MV3
contextMenus Добавляет элементы в контекстное меню (контекстное меню) в Microsoft Edge. Элементы меню могут применяться к разным объектам, таким как изображения, гиперссылки и страницы. MV2, MV3
Печенье Запрашивает и изменяет файлы cookie и получает уведомления при их изменении. MV2, MV3
отладчик Подключается к одной или нескольким вкладкам для инструментирования сетевого взаимодействия, отладки JavaScript, изменения модели DOM, изменения CSS и т. д. Используйте отладчики tabId для назначения вкладок с sendCommandпомощью и перенаправления событий из tabIdonEvent обратных вызовов. MV2, MV3
declarativeContent Выполняет действия в зависимости от содержимого страницы, не требуя разрешения на чтение содержимого страницы. MV2, MV3
declarativeNetRequest Обеспечивает большую конфиденциальность, блокируя или изменяя сетевые запросы путем указания декларативных правил. Позволяет расширениям изменять сетевые запросы без перехвата запроса и просмотра содержимого. MV2, MV3
desktopCapture Записывает содержимое экрана, отдельных окон или вкладок. MV2, MV3
devtools.inspectedWindow Взаимодействует с проверенным окном. Например, получает идентификатор вкладки страниц, оценивает код, обновляет страницы или получает ресурсы на странице. MV2, MV3
devtools.network Извлекает сведения о сетевых запросах, отображаемых средством DevTools Network . MV2, MV3
devtools.panels Интегрирует расширение в пользовательский интерфейс окна Средства разработчика путем создания собственных панелей, доступа к существующим панелям или добавления боковых панелей. MV2, MV3
dns Разрешает DNS-адреса. MV2, MV3. Канал разработки.
dom Обращается к специальным API DOM для расширений. MV2, MV3
Загрузки Программный запуск, мониторинг, управление и поиск скачиваемого файла. MV2, MV3
enterprise.hardwarePlatform Возвращает производителя и модель аппаратной платформы, на которой работает браузер. Для расширений, установленных корпоративной политикой. MV2, MV3
События Распространенные типы, используемые API- интерфейсами, которые вызывают события для уведомления о возникновении интересного события. MV2, MV3
расширение Служебные программы, которые можно использовать на любой странице расширения. Включает поддержку обмена сообщениями между расширением и скриптами содержимого или между расширениями. MV2, MV3
extensionTypes Объявления типов для расширений Microsoft Edge. MV2, MV3
fontSettings Управляет параметрами шрифта в Microsoft Edge. MV2, MV3
история Взаимодействует с записью браузера о посещенных страницах. Вы можете добавлять, удалять ИЛИ запрашивать URL-адреса в журнале браузера. Чтобы переопределить страницу журнала собственной версией, перейдите в раздел Переопределение страниц. MV2, MV3
i18n Реализует интернационализацию во всем приложении или расширении. MV2, MV3
identity Возвращает маркеры доступа OAuth2. Не поддерживается: identity.getAccounts, identity.getAuthToken — в качестве альтернативного варианта можно использовать identity.launchWebAuthFlow для получения маркера OAuth2 для проверки подлинности пользователей. MV2, MV3
неработающий Определяет, когда изменяется состояние простоя компьютера. MV2, MV3
input.ime Реализует пользовательский IME для ОС, позволяющий расширению обрабатывать нажатия клавиш, задавать композицию и управлять окном-кандидатом. MV2, MV3
управление Управляет списком установленных или запущенных расширений. Можно переопределить встроенную страницу "Новая вкладка". MV2, MV3
Уведомления Создает расширенные уведомления с помощью шаблонов и отображает их в области уведомлений. MV2, MV3
закадровый Создает и управляет внеэкранными документами. MV3
omnibox Регистрирует ключевые слова в адресной строке Microsoft Edge, также известной как omnibox. MV2, MV3
pageAction Добавляет значки на панель инструментов Microsoft Edge справа от адресной строки. Действия страницы — это действия, которые могут выполняться на текущей странице и применимы не ко всем страницам. Действия страницы отображаются серым цветом при неактивном состоянии. MV2
pageCapture Сохраняет вкладки как MHTML-файлы. MV2, MV3
permissions Получает объявленные необязательные разрешения во время выполнения, а не во время установки. Этот API можно использовать для отображения необходимых и утвержденных разрешений для пользователей. MV2, MV3
сила Переопределяет функции управления питанием системы. MV2, MV3
printerProvider Использует события для запроса принтеров, их возможностей и отправки заданий печати. MV2, MV3
конфиденциальность Управляет функциями Microsoft Edge, влияющими на конфиденциальность пользователя. Этот API зависит EdgeSetting от прототипа types для получения и настройки конфигурации Microsoft Edge. MV2, MV3
Процессов Взаимодействует с процессами браузера. MV2, MV3. Канал разработки.
доверенность Управляет параметрами прокси-сервера для Microsoft Edge. Этот API зависит EdgeSetting от прототипа types API для получения и настройки конфигурации прокси-сервера Microsoft Edge. MV2, MV3
runtime Извлекает фоновую страницу, возвращает сведения о манифесте и прослушивает события в жизненном цикле приложения или расширения и реагирует на них. Можно также преобразовать относительный путь URL-адресов в полные URL-адреса. MV2, MV3
Сценариев Выполняет скрипты в разных контекстах. MV3
искать Выполняет поиск с помощью поставщика по умолчанию. MV2, MV3
Сеансов Запросы и восстановление вкладок и окон из сеанса просмотра. MV2, MV3
sidePanel Размещает пользовательское содержимое на боковой панели браузера вместе с main содержимым веб-страницы. См . раздел Разработка расширения для боковой панели Microsoft Edge. MV3
хранение Сохраняет, извлекает и отслеживает изменения в пользовательских данных. MV2, MV3
system.cpu Запрашивает метаданные ЦП. MV2, MV3
system.display Запросы отображают метаданные. MV2, MV3
system.memory Сообщает о доступной емкости памяти и общем объеме физической памяти. MV2, MV3
system.storage Запрашивает сведения об устройствах хранения. Вы также можете получать уведомления о подключении или отключении устройств хранения. MV2, MV3
tabCapture Взаимодействует с потоками мультимедиа табуляции. MV2, MV3
tabGroups Взаимодействует с системой группирования вкладок браузера. Изменяет и переупорядочение групп вкладок в браузере. Чтобы группировать и разгруппировать вкладки или запрашивать, какие вкладки находятся в группах, используйте API вкладок . MV3
Вкладки Взаимодействует с системой вкладок браузера для создания, изменения и переупорядочения вкладок. MV2, MV3
topSites Обращается к лучшим сайтам, которые также называются наиболее посещаемыми сайтами, которые отображаются на новой странице вкладки. Эти сайты не включают ярлыки, настраиваемые пользователем. MV2, MV3
tts Воспроизводит синтезированный текст в речь (TTS). MV2, MV3
ttsEngine Реализует подсистему преобразования текста в речь (TTS) с помощью расширения. Расширения, которые регистрируются для использования этого API, получают события, содержащие речевые фрагменты и другие параметры. Затем расширения могут использовать любую доступную веб-технологию для синтеза и вывода речи, а также отправлять события обратно в вызывающую функцию, чтобы сообщить о состоянии. MV2, MV3
types Объявления типов для Microsoft Edge. MV2, MV3
userScripts Выполняет пользовательские скрипты в контексте пользовательских скриптов. MV3
webAuthenticationProxy Позволяет программному обеспечению удаленного рабочего стола, работающему на удаленном узле, перехватывать запросы API веб-проверки подлинности (WebAuthn) для их обработки на локальном клиенте. MV3
webNavigation Получает уведомления о состоянии запросов навигации. MV2, MV3
webRequest Отслеживает и анализирует трафик. Перехватывает, блокирует или изменяет запросы. MV2, MV3
виндоус Взаимодействует с окнами браузера для создания, изменения и изменения порядка окон в браузере. MV2, MV3

Неподдерживаемые интерфейсы API

Эти API расширений не поддерживаются для Microsoft Edge.

API Примечания
аудио Только ChromeOS.
certificateProvider Только ChromeOS.
devtools.recorder Только Chrome DevTools.
documentScan Только ChromeOS.
enterprise.deviceAttributes Только ChromeOS.
enterprise.networkingAttributes Только ChromeOS.
enterprise.platformKeys Только ChromeOS.
fileBrowserHandler Только ChromeOS.
fileSystemProvider Только ChromeOS.
gcm
identity.getAccounts
identity.getAuthToken Получает маркер доступа OAuth2, используя идентификатор клиента и области, указанные в разделе oauth2 объекта manifest.json. В качестве альтернативного варианта можно использовать identity.launchWebAuthFlow для получения маркера OAuth2 для проверки подлинности пользователей.
instanceID
loginState Только ChromeOS.
platformKeys Только ChromeOS.
печатание Только ChromeOS.
printingMetrics Только ChromeOS.
readingList
vpnProvider Только ChromeOS.
обои Только ChromeOS.

Дополнительные рекомендации по поддерживаемым API

  • Пользователь должен войти в Microsoft Edge с помощью учетной записи Майкрософт (MSA) или Microsoft Entra ID учетной записи для использования chrome.identity.getProfileUserInfo. Если пользователь вошел в Microsoft Edge с помощью локальной учетной записи Microsoft Entra ID, API возвращает null значения электронной почты и идентификатора.

    Учетная запись Майкрософт (MSA) — это учетная запись Outlook.com, Live.com или Hotmail.com.

  • Microsoft Edge не поддерживает расширения, использующие платежи в Веб-магазине Chrome, так как используется identity.getAuthtoken для запроса маркеров для пользователей, вошедшего в систему. Эти маркеры отправляются в API лицензирования на основе REST.

Примечание.

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой Google и используемой в соответствии с условиями, описанными в международной лицензии Creative Commons Attribution 4.0. Исходная страница находится здесь.

Creative Commons License Эта работа лицензируется по международной лицензии Creative Commons Attribution 4.0.

См. также