Depurar suplementos no Office na Web

  • Artigo

Este artigo descreve como usar Office na Web para depurar seus suplementos. Use esta técnica:

  • Para depurar suplementos em um computador que não está executando o Windows ou o cliente da área de trabalho do Office, por exemplo, se você estiver desenvolvendo em um Mac ou Linux.
  • Como um processo de depuração alternativo, se você não puder ou não desejar, depurar em um IDE, como Visual Studio ou Visual Studio Code.

Este artigo pressupõe que você tenha um projeto de suplemento que precisa ser depurado. Se você quiser apenas praticar a depuração na Web, crie um novo projeto usando um dos inícios rápidos para aplicativos específicos do Office, como este início rápido para Word.

Depurar o suplemento

Para depurar seu suplemento usando o Office na Web:

  1. Execute o projeto em localhost e abasque-o em um documento no Office na Web. Para obter instruções detalhadas de sideload, consulte Carregar manualmente suplementos do Office na Web.

  2. Abra as ferramentas de desenvolvedor do navegador. Isso geralmente é feito pressionando F12. Abra a ferramenta de depurador e use-a para definir pontos de interrupção e watch variáveis. Para obter ajuda detalhada no uso da ferramenta do navegador, confira um dos seguintes procedimentos:

    Observação

    • Office na Web não abrirá na Internet Explorer.
    • O novo cliente da área de trabalho do Outlook on Window (versão prévia) não dá suporte ao menu de contexto ou ao atalho de teclado para acessar as ferramentas de desenvolvedor do Microsoft Edge. Em vez disso, você deve executar olk.exe --devtools a partir de um prompt de comando. Para obter mais informações, confira a seção "Depurar seu suplemento" de Desenvolver suplementos do Outlook para o novo Outlook no Windows (versão prévia).

Possíveis problemas

A seguir estão alguns problemas que você pode encontrar ao depurar.

  • Alguns erros de JavaScript que você vê podem vir do Office na Web.
  • O navegador pode mostrar um erro de certificado inválido que você precisará ignorar. O processo para fazer isso varia com o navegador e as interfaces de usuário dos vários navegadores para fazer essa alteração periodicamente. Você deve pesquisar na ajuda do navegador ou pesquisar online para obter instruções. (Por exemplo, procure por "Aviso de certificado inválido do Microsoft Edge".) A maioria dos navegadores terá um link na página de aviso que permite que você clique na página do suplemento. Por exemplo, o Microsoft Edge tem um link "Ir para a página da Web (Não recomendado)". Mas você geralmente terá que passar por esse link sempre que o suplemento recarregar. Para um bypass mais duradouro, consulte a ajuda, como sugerido.
  • Se você definir pontos de interrupção em seu código, Office na Web poderá gerar um erro indicando que não é possível salvar.

Confira também