Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 devolvenullos 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.getAuthtokenpara 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.
Este trabalho é licenciado ao abrigo de uma Licença Internacional creative Commons Attribution 4.0.