Partilhar via

APIs suportadas para extensões do Microsoft Edge

  • Artigo

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
accessibilityFeatures Gere as funcionalidades de acessibilidade do browser. MV2, MV3
action Controla o ícone da extensão na barra de ferramentas do browser. MV3
alarmes Agenda código para ser executado periodicamente ou numa hora especificada no futuro. MV2, MV3
marcadores Cria, organiza e manipula marcadores. MV2, MV3
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
browsingData Remove os dados de navegação do perfil local de um utilizador. MV2, MV3
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
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
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
cookies Consulta e modifica cookies e recebe notificações quando mudam. MV2, MV3
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
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
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
desktopCapture Captura o conteúdo de um ecrã, janelas individuais ou separadores. MV2, MV3
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
devtools.network Obtém informações sobre pedidos de rede que são apresentados pela ferramenta de Rede DevTools. MV2, MV3
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
dns Resolve os endereços DNS. MV2, MV3. Canal Dev.
dom Acede a APIs DOM especiais para Extensões. MV2, MV3
transferências Inicia programaticamente, monitoriza, manipula e procura transferências. MV2, MV3
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
eventos Tipos comuns utilizados pelas APIs que geram eventos para notificá-lo quando ocorre um evento interessante. MV2, MV3
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
extensionTypes Escreva declarações para extensões do Microsoft Edge. MV2, MV3
fontSettings Gere as definições do tipo de letra no Microsoft Edge. MV2, MV3
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
i18n Implementa a internacionalização em toda a sua aplicação ou extensão. MV2, MV3
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
inativo Deteta quando o estado de inatividade do computador é alterado. MV2, MV3
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
gestão Gere a lista de extensões instaladas ou em execução. Pode substituir a página Novo Separador incorporada. MV2, MV3
notificações Cria notificações avançadas com modelos e apresenta-as no tabuleiro do sistema. MV2, MV3
fora do ecrã Cria e gere documentos offscreen. MV3
omnibox Regista palavras-chave na barra de endereço do Microsoft Edge, também conhecida como omnibox. MV2, MV3
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
pageCapture Guarda separadores como ficheiros MHTML. MV2, MV3
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
energia Substitui as funcionalidades de gestão de energia do sistema. MV2, MV3
printerProvider Utiliza eventos para consultar impressoras, as respetivas capacidades e submeter tarefas de impressão. MV2, MV3
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
processos Interage com os processos do browser. MV2, MV3. Canal Dev.
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
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
scripting Executa scripts em diferentes contextos. MV3
procurar Procura através do fornecedor predefinido. MV2, MV3
sessões Consulta e restaura separadores e janelas a partir de uma sessão de navegação. MV2, MV3
sidePanel Aloja conteúdo personalizado na barra lateral do browser juntamente com o conteúdo main de uma página Web. Consulte Desenvolver uma extensão para a barra lateral do Microsoft Edge. MV3
armazenamento Armazena, obtém e regista alterações aos dados do utilizador. MV2, MV3
system.cpu Consulta metadados da CPU. MV2, MV3
system.display As consultas apresentam metadados. MV2, MV3
system.memory Comunica a capacidade de memória disponível e a capacidade total de memória física. MV2, MV3
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
tabCapture Interage com fluxos de multimédia de tabulação. MV2, MV3
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
separadores Interage com o sistema de separadores do browser para criar, modificar e reorganizar separadores. MV2, MV3
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
tts Reproduz a conversão de texto em voz sintetizada (TTS). MV2, MV3
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
types Escreva declarações para o Microsoft Edge. MV2, MV3
userScripts Executa scripts de utilizador no contexto Scripts de Utilizador. MV3
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
webNavigation Recebe notificações sobre a status de pedidos de navegação. MV2, MV3
webRequest Observa e analisa o tráfego. Interceta, bloqueia ou modifica pedidos. MV2, MV3
windows Interage com as janelas do browser para criar, modificar e reorganizar janelas no browser. MV2, MV3

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