Compartilhar via


APIs suportadas para extensões do Microsoft Edge

As extensões do Microsoft Edge utilizam um subconjunto dos métodos JavaScript para a plataforma Chromium motor do browser. Ao criar uma extensão para o browser Microsoft Edge, pode utilizar as seguintes APIs.

API Descrição Versões do manifesto Plataformas
accessibilityFeatures Gere as funcionalidades de acessibilidade do browser. MV2, MV3 Windows, Linux, Mac
action Controla o ícone da extensão na barra de ferramentas do browser. MV3 Windows, Linux, Mac, Android
alarmes Agenda código para ser executado periodicamente ou numa hora especificada no futuro. MV2, MV3 Windows, Linux, Mac, Android
marcadores Cria, organiza e manipula marcadores. MV2, MV3 Windows, Linux, Mac
browserAction Utiliza ações do browser para colocar ícones na barra de ferramentas no Microsoft Edge. Também pode utilizar ações do browser para adicionar uma descrição, distintivo ou pop-up. MV2 Windows, Linux, Mac, Android
browsingData Remove os dados de navegação do perfil local de um utilizador. MV2, MV3 Windows, Linux, Mac, Android
comandos Adiciona atalhos de teclado que acionam ações na extensão, como uma ação para abrir o browser ou enviar um comando para a extensão. MV2, MV3 Windows, Linux, Mac
contentSettings Personaliza o comportamento do Microsoft Edge em cada site, em vez de globalmente. Altera as definições que controlam se os sites podem utilizar funcionalidades como cookies, JavaScript e plug-ins. MV2, MV3 Windows, Linux, Mac, Android
contextMenus Adiciona itens ao menu de contexto (menu de contexto) no Microsoft Edge. Os itens de menu podem ser aplicados a objetos diferentes, como imagens, hiperligações e páginas. MV2, MV3 Windows, Linux, Mac
cookies Consulta e modifica cookies e recebe notificações quando mudam. MV2, MV3 Windows, Linux, Mac, Android
depurador Anexa a um ou mais separadores para instrumentar a interação de rede, depurar JavaScript, alterar o DOM, alterar CSS, etc. Utilize o Debuggee's tabId para direcionar os separadores com sendCommande encaminhar eventos através tabId de chamadas de onEvent retorno. MV2, MV3 Windows, Linux, Mac
declarativeContent Executa ações consoante o conteúdo de uma página, sem que seja necessária permissão para ler o conteúdo da página. MV2, MV3 Windows, Linux, Mac, Android
declarativeNetRequest Fornece mais privacidade ao bloquear ou modificar pedidos de rede ao especificar regras declarativas. Permite que as extensões modifiquem pedidos de rede sem intercetar o pedido e ver o conteúdo. MV2, MV3 Windows, Linux, Mac, Android
desktopCapture Captura o conteúdo de um ecrã, janelas individuais ou separadores. MV2, MV3 Windows, Linux, Mac
devtools.inspectedWindow Interage com a janela inspecionada. Por exemplo, obtém o ID de separador de páginas, avalia código, atualiza páginas ou obtém recursos numa página. MV2, MV3 Windows, Linux, Mac
devtools.network Obtém informações sobre pedidos de rede que são apresentados pela ferramenta de Rede DevTools. MV2, MV3 Windows, Linux, Mac
devtools.panels Integra a sua extensão na IU da janela Ferramentas de Programação ao criar os seus próprios painéis, aceder a painéis existentes ou adicionar barras laterais. MV2, MV3 Windows, Linux, Mac
dns Resolve os endereços DNS. MV2, MV3. Canal Dev. Windows, Linux, Mac
dom Acede a APIs DOM especiais para Extensões. MV2, MV3 Windows, Linux, Mac, Android
transferências Inicia programaticamente, monitoriza, manipula e procura transferências. MV2, MV3 Windows, Linux, Mac, Android
enterprise.hardwarePlatform Obtém o fabricante e o modelo da plataforma de hardware onde o browser é executado. Para extensões que são instaladas pela política empresarial. MV2, MV3 Windows, Linux, Mac
eventos Tipos comuns utilizados pelas APIs que geram eventos para notificá-lo quando ocorre um evento interessante. MV2, MV3 Windows, Linux, Mac
extensão Utilitários que podem ser utilizados por qualquer página de extensão. Inclui suporte para a troca de mensagens entre uma extensão e os respetivos scripts de conteúdo ou entre extensões. MV2, MV3 Windows, Linux, Mac, Android
extensionTypes Escreva declarações para extensões do Microsoft Edge. MV2, MV3 Windows, Linux, Mac
fontSettings Gere as definições do tipo de letra no Microsoft Edge. MV2, MV3 Windows, Linux, Mac
histórico Interage com o registo de páginas visitadas do browser. Pode adicionar, remover ou consultar URLs no histórico do browser. Para substituir a página do histórico pela sua própria versão, navegue para Substituir Páginas. MV2, MV3 Windows, Linux, Mac, Android
i18n Implementa a internacionalização em toda a sua aplicação ou extensão. MV2, MV3 Windows, Linux, Mac, Android
identity Obtém tokens de acesso OAuth2. Não suportado: identity.getAccounts, identity.getAuthToken – como alternativa, pode utilizar identity.launchWebAuthFlow para obter um token OAuth2 para autenticar os utilizadores. MV2, MV3 Windows, Linux, Mac, Android
inativo Deteta quando o estado de inatividade do computador é alterado. MV2, MV3 Windows, Linux, Mac, Android
input.ime Implementa um IME personalizado para o SO, permitindo que uma extensão processe batimentos de teclas, defina a composição e faça a gestão da janela de candidatos. MV2, MV3 Windows, Linux, Mac
gestão Gere a lista de extensões instaladas ou em execução. Pode substituir a página Novo Separador incorporada. MV2, MV3 Windows, Linux, Mac, Android
notificações Cria notificações avançadas com modelos e apresenta-as no tabuleiro do sistema. MV2, MV3 Windows, Linux, Mac, Android
fora do ecrã Cria e gere documentos offscreen. MV3 Windows, Linux, Mac, Android
omnibox Regista palavras-chave na barra de Endereço do Microsoft Edge, também conhecida como omnibox. MV2, MV3 Windows, Linux, Mac
pageAction Adiciona ícones à barra de ferramentas do Microsoft Edge, à direita da Barra de endereço. As ações de página são ações que podem ser executadas na página atual e não são aplicáveis a todas as páginas. As ações de página aparecem desativadas quando estão inativas. MV2 Windows, Linux, Mac, Android
pageCapture Guarda separadores como ficheiros MHTML. MV2, MV3 Windows, Linux, Mac
permissões Obtém permissões declaradas opcionais no runtime, em vez de no momento da instalação. Pode utilizar esta API para apresentar as permissões necessárias e aprovadas aos seus utilizadores. MV2, MV3 Windows, Linux, Mac, Android
energia Substitui as funcionalidades de gestão de energia do sistema. MV2, MV3 Windows, Linux, Mac
printerProvider Utiliza eventos para consultar impressoras, as respetivas capacidades e submeter tarefas de impressão. MV2, MV3 Windows, Linux, Mac
privacidade Controla as funcionalidades no Microsoft Edge que afetam a privacidade de um utilizador. Esta API depende do EdgeSetting protótipo de types para obter e definir a configuração do Microsoft Edge. MV2, MV3 Windows, Linux, Mac
processos Interage com os processos do browser. MV2, MV3. Canal Dev. Windows, Linux, Mac
proxy Gere as definições de proxy do Microsoft Edge. Esta API depende do EdgeSetting protótipo da types API para obter e definir a configuração de proxy do Microsoft Edge. MV2, MV3 Windows, Linux, Mac
runtime Obtém a página de fundo, devolve detalhes sobre o manifesto e escuta e responde a eventos no ciclo de vida da aplicação ou da extensão. Também pode converter o caminho relativo dos URLs em URLs completamente qualificados. MV2, MV3 Windows, Linux, Mac, Android
scripting Executa scripts em diferentes contextos. MV3 Windows, Linux, Mac, Android
procurar Procura através do fornecedor predefinido. MV2, MV3 Windows, Linux, Mac, Android
sessões Consulta e restaura separadores e janelas a partir de uma sessão de navegação. MV2, MV3 Windows, Linux, Mac, Android
sidePanel Aloja conteúdo personalizado na barra lateral do browser juntamente com o conteúdo principal de uma página Web. Consulte Desenvolver uma extensão para a barra lateral do Microsoft Edge. MV3 Windows, Linux, Mac
armazenamento Armazena, obtém e regista alterações aos dados do utilizador. MV2, MV3 Windows, Linux, Mac, Android
system.cpu Consulta metadados da CPU. MV2, MV3 Windows, Linux, Mac, Android
system.display As consultas apresentam metadados. MV2, MV3 Windows, Linux, Mac
system.memory Comunica a capacidade de memória disponível e a capacidade total de memória física. MV2, MV3 Windows, Linux, Mac, Android
system.storage Consulta informações sobre dispositivos de armazenamento. Também pode receber notificações quando os dispositivos de armazenamento estão ligados ou desanexados. MV2, MV3 Windows, Linux, Mac
tabCapture Interage com fluxos de multimédia de tabulação. MV2, MV3 Windows, Linux, Mac
tabGroups Interage com o sistema de agrupamento de separadores do browser. Modifica e reorganiza grupos de separadores no browser. Para agrupar e desagrupar separadores ou para consultar que separadores estão em grupos, utilize a API de separadores . MV3 Windows, Linux, Mac
separadores Interage com o sistema de separadores do browser para criar, modificar e reorganizar separadores. MV2, MV3 Windows, Linux, Mac, Android
topSites Acede aos sites principais, também denominados sites mais visitados, que são apresentados na nova página de separador. Estes sites não incluem atalhos personalizados pelo utilizador. MV2, MV3 Windows, Linux, Mac
tts Reproduz a conversão de texto em voz sintetizada (TTS). MV2, MV3 Windows, Linux, Mac
ttsEngine Implementa um motor de conversão de texto em voz (TTS) com uma extensão. As extensões registadas para utilizar esta API recebem eventos que contêm expressões a serem faladas e outros parâmetros. Em seguida, as extensões podem utilizar qualquer tecnologia Web disponível para sintetizar e exportar voz e enviar eventos de volta para a função de chamada para comunicar o status. MV2, MV3 Windows, Linux, Mac
types Escreva declarações para o Microsoft Edge. MV2, MV3 Windows, Linux, Mac
userScripts Executa scripts de utilizador no contexto Scripts de Utilizador. MV3 Windows, Linux, Mac, Android
WebAuthenticationProxy Permite que o software de ambiente de trabalho remoto em execução num anfitrião remoto intercete pedidos da API de Autenticação Web (WebAuthn) para os processar num cliente local. MV3 Windows, Linux, Mac
webNavigation Recebe notificações sobre a status de pedidos de navegação. MV2, MV3 Windows, Linux, Mac, Android
webRequest Observa e analisa o tráfego. Interceta, bloqueia ou modifica pedidos. MV2, MV3 Windows, Linux, Mac, Android
windows Interage com as janelas do browser para criar, modificar e reorganizar janelas no browser. MV2, MV3 Windows, Linux, Mac

APIs sem suporte

Estas APIs de Extensões não são suportadas para o Microsoft Edge.

API Observações
áudio Apenas ChromeOS.
certificateProvider Apenas ChromeOS.
devtools.recorder Apenas Chrome DevTools.
documentScan Apenas ChromeOS.
enterprise.deviceAttributes Apenas ChromeOS.
enterprise.networkingAttributes Apenas ChromeOS.
enterprise.platformKeys Apenas ChromeOS.
fileBrowserHandler Apenas ChromeOS.
fileSystemProvider Apenas ChromeOS.
gcm
identity.getAccounts
identity.getAuthToken Obtém um token de acesso OAuth2 com o ID de cliente e os âmbitos especificados na secção oauth2 de manifest.json. Como alternativa, pode utilizar identity.launchWebAuthFlow para obter um token OAuth2 para autenticar utilizadores.
instanceID
loginState Apenas ChromeOS.
platformKeys Apenas ChromeOS.
impressão Apenas ChromeOS.
printingMetrics Apenas ChromeOS.
lista de leitura
vpnProvider Apenas ChromeOS.
padrão de fundo Apenas ChromeOS.

Considerações adicionais para APIs suportadas

  • O utilizador tem de ter sessão iniciada no Microsoft Edge com uma conta Microsoft (MSA) ou Microsoft Entra ID conta para utilizar chrome.identity.getProfileUserInfo. Se o utilizador tiver sessão iniciada no Microsoft Edge com uma conta Microsoft Entra ID no local, a API devolve null os valores de E-mail e ID.

    Uma conta Microsoft (MSA) é uma conta Outlook.com, Live.com ou Hotmail.com.

  • O Microsoft Edge não suporta extensões que utilizam pagamentos da Chrome Web Store porque utiliza identity.getAuthtoken para pedir tokens para utilizadores com sessão iniciada. Estes tokens são enviados para a API de licenciamento baseada em REST.

Observação

Partes desta página são modificações baseadas no trabalho criado e partilhado pela Google e utilizado de acordo com os termos descritos na Licença Internacional Creative Commons Attribution 4.0. A página original encontra-se aqui.

Licença Creative Commons Este trabalho é licenciado ao abrigo de uma Licença Internacional creative Commons Attribution 4.0.

Confira também