Navegadores usados pelos Suplementos do Office

Office suplementos são aplicativos Web exibidos usando iFrames durante a execução em Office na Web. No Office para clientes desktop e móveis, Office suplementos usam um controle de navegador inserido (também conhecido como modo de exibição da Web). Os suplementos também precisam de um mecanismo JavaScript para executar o JavaScript. O navegador inserido e o mecanismo são fornecidos por um navegador instalado no computador do usuário.

Qual navegador é usado depende do:

  • O sistema operacional do computador.
  • Se o suplemento está em execução no Office na Web, Microsoft 365 ou não Office 2013 ou posterior.

Importante

O Internet Explorer ainda é Office suplementos

Algumas combinações de plataformas e versões do Office, incluindo versões de compra única por meio do Office 2019, ainda usam o controle de modo de exibição da Web que vem com o Internet Explorer 11 para hospedar suplementos, conforme explicado neste artigo. Recomendamos (mas não exige) que você continue a dar suporte a essas combinações, pelo menos de maneira mínima, fornecendo aos usuários do seu suplemento uma mensagem de falha normal quando o suplemento é iniciado no modo de exibição da Web do Internet Explorer. Lembre-se destes pontos adicionais:

  • Office na Web abre mais no Internet Explorer. Consequentemente, o AppSource não testa mais suplementos no Office na Web usando o Internet Explorer como navegador.
  • O AppSource ainda testa combinações de versões de plataforma e área de trabalho do Office que usam o Internet Explorer, no entanto, ele só emite um aviso quando o suplemento não dá suporte ao Internet Explorer; o suplemento não é rejeitado pelo AppSource.
  • A Script Lab não dá mais suporte ao Internet Explorer.

Para obter mais informações sobre como dar suporte ao Internet Explorer e configurar uma mensagem de falha normal em seu suplemento, consulte Suporte do Internet Explorer 11.

A tabela a seguir mostra qual navegador é usado pelas várias plataformas e sistemas operacionais.

SO Versão do Office Edge WebView2 (baseado Chromium) instalado? Navegador
qualquer Office na Web Não aplicável O navegador no qual o Office está aberto.
(Mas observe que Office na Web não será aberto no Internet Explorer.
A tentativa de fazer isso abre Office na Web no Edge.)
Mac qualquer Não aplicável Safari com WKWebView
iOS qualquer Não aplicável Safari com WKWebView
Android qualquer Não aplicável Chrome
Windows 7, 8.1, 10, 11 não assinatura Office 2013 para Office 2019 Não importa, não importa. Internet Explorer 11
Windows 10, 11 não assinatura Office 2021 ou posterior Sim Microsoft Edge 1 com WebView2 (baseado em Chromium)
Windows 7 Microsoft 365 Não importa, não importa. Internet Explorer 11
Windows 8.1,
Windows 10 ver. <  1903
Microsoft 365 Não Internet Explorer 11
Windows 10 ver. >=  1903,
Windows 11
Microsoft 365 ver. <  16.0.116292 Não importa, não importa. Internet Explorer 11
Windows 10 ver. >=  1903,
Windows 11
Microsoft 365 ver. >=  16.0.11629AND16.0.13530.204242   Não importa, não importa. Microsoft Edge 1, 3 com WebView original (EdgeHTML)
Windows 10 ver. >=  1903,
Janela 11
Microsoft 365 ver. >=  16.0.13530.204242 Não Microsoft Edge 1, 3 com WebView original (EdgeHTML)
Windows 8.1
Windows 10,
Windows 11
Microsoft 365 ver. >=  16.0.13530.204242 Sim4 Microsoft Edge 1 com WebView2 (baseado em Chromium)

1 Quando Microsoft Edge está sendo usado, o Windows Narrador (às vezes chamado de "leitor de tela") <title> lê a marca na página que é aberta no painel de tarefas. Quando o Internet Explorer 11 está sendo usado, o Narrador lê a barra de título do painel de tarefas, que vem do valor <DisplayName> no manifesto de suplemento.

2 Consulte a página de histórico de atualizações e como encontrar sua versão Office cliente e o canal de atualização para obter mais detalhes.

3 Se <Runtimes> o suplemento incluir o elemento no manifesto, ele não usará Microsoft Edge WebView original (EdgeHTML). Se as condições para usar Microsoft Edge com o WebView2 (baseado em Chromium) forem atendidas, o suplemento usará esse navegador. Caso contrário, ele usará o Internet Explorer 11, independentemente do Windows ou Microsoft 365 versão. Para mais informações, consulte Runtimes.

4 Em Windows versões anteriores Windows 11, o controle WebView2 deve ser instalado para que Office possa inseri-lo. Ele é instalado com Microsoft 365, versão 2101 ou posterior, e com compra única Office 2021 ou posterior; mas não é instalado automaticamente com o Microsoft Edge. Se você tiver uma versão anterior do Microsoft 365 ou de compra única Office, use as instruções para instalar o controle no Microsoft Edge WebView2/Inserir conteúdo da Web... com Microsoft Edge WebView2. No Microsoft 365 builds anteriores a 16.0.14326.xxxxx, você também deve criar a chave do RegistroHKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 e definir seu valor como dword:00000001.

Importante

O Internet Explorer 11 não oferece suporte às versões do JavaScript posteriores a ES5. Se algum dos usuários do suplemento tiver plataformas que usam o Internet Explorer 11, para usar a sintaxe e os recursos do ECMAScript 2015 ou posterior, você terá duas opções.

  • Escreva seu código no ECMAScript 2015 (também chamado de ES6) ou em JavaScript posterior ou em TypeScript e, em seguida, compile seu código em JavaScript ES5 usando um compilador como babel ou tsc.
  • Escreva no ECMAScript 2015 ou em JavaScript posterior, mas também carregue uma biblioteca de polyfill , como core-js , que permite que o IE execute seu código.

Para obter mais informações sobre essas opções, consulte Suporte do Internet Explorer 11.

Além disso, o Internet Explorer 11 não oferece suporte a alguns recursos do HTML5, como mídia, gravação e localização. Para saber mais, confira Determinar em runtime se o suplemento está em execução no Internet Explorer.

Solução de Microsoft Edge problemas

Os Trabalhadores do Serviço não estão funcionando

Office suplementos não dão suporte a Service Workers quando o Microsoft Edge WebView original, EdgeHTML, é usado. Eles têm suporte com o Edge WebView2 Chromium baseado em Chromium.

Barra de rolagem não aparece no painel de tarefas

Por padrão, as barras de rolagem no Microsoft Edge estão ocultas até que você tenha passado. Para garantir que a barra de rolagem fique sempre visível, o estilo de CSS que se aplica ao elemento <body> das páginas no painel de tarefas deve incluir a propriedade (-ms- reoverflow-style) e deve ser definida como scrollbar.

Ao depurar com o Microsoft Edge DevTools, o suplemento falha ou recarrega

A definição de pontos de interrupção nas DevTools do Microsoft Edge pode fazer o Office pensar que o suplemento está travado. Ele recarrega automaticamente o suplemento quando isso acontece. Para evitar isso, adicione a seguinte chave do registro e valor ao computador de desenvolvimento [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000:.

Quando o suplemento tentar abrir, o erro “ADD-IN ERROR não é possível abrir este suplemento a partir do localhost" acontece

Uma causa conhecida é que o Microsoft Edge exige que o localhost tenha uma isenção de auto-retorno no computador de desenvolvimento. Siga as instruções em não é possível abrir o suplemento do localhost.

Obter erros ao tentar baixar um arquivo PDF

Não há suporte para o download direto de blobs como arquivos PDF em um suplemento quando o Edge é o navegador. A solução alternativa é criar um aplicativo Web simples que baixa blobs como arquivos PDF. No suplemento, chame o método Office.context.ui.openBrowserWindow(url) e passe a URL do aplicativo Web. Isso abrirá o aplicativo Web em uma janela do navegador fora do Office.

Confira também