Поддерживаемые API для расширений Microsoft Edge
При создании расширений для браузера Microsoft Edge можно использовать следующие API.
| API | Описание | Версии манифеста |
|---|---|---|
| accessibilityFeatures | Управляет специальными возможностями Chrome. | 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 |
| Windows | Взаимодействует с окнами браузера для создания, изменения и изменения порядка окон в браузере. | 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 идентификатора, чтобы использовать
chrome.identity.getProfileUserInfo. Если пользователь вошел в Microsoft Edge с помощью локальной учетной записи идентификатора Microsoft Entra, API возвращаетnullзначения электронной почты и идентификатора.Учетная запись Майкрософт (MSA) — это учетная запись Outlook.com, Live.com или Hotmail.com.
Microsoft Edge не поддерживает расширения, использующие платежи в Веб-магазине Chrome, так как используется
identity.getAuthtokenдля запроса маркеров для пользователей, вошедшего в систему. Эти маркеры отправляются в API лицензирования на основе REST.
Примечание.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой Google и используемой в соответствии с условиями, описанными в международной лицензии Creative Commons Attribution 4.0. Исходная страница находится здесь.
Эта работа лицензируется по международной лицензии Creative Commons Attribution 4.0.