Depurar suplementos usando ferramentas de desenvolvedor no Microsoft Edge (baseado em Chromium)

Este artigo mostra como depurar o código do lado do cliente (JavaScript ou TypeScript) do suplemento quando são cumpridas as seguintes condições.

• Não pode, ou não pretender, depurar com ferramentas incorporadas no seu IDE; ou encontra um problema que só ocorre quando o suplemento é executado fora do IDE.
• O seu computador está a utilizar uma combinação de versões do Windows e do Office que utilizam o controlo webview edge (baseado em Chromium), WebView2.

Para determinar que vista Web está a utilizar, consulte Browsers e controlos webview utilizados pelos Suplementos do Office.

Depurar um suplemento do painel de tarefas com as ferramentas de programador do Microsoft Edge (baseado no Chromium)

1. Faça sideload e execute o suplemento.

   Observação

   Para fazer sideload de um suplemento no Outlook, veja Sideload Outlook add-ins for testing (Sideload de suplementos do Outlook para testes).

2. Execute as ferramentas de programador do Microsoft Edge (baseado em Chromium) através de um destes métodos:

   • Certifique-se de que o painel de tarefas do suplemento tem o foco e prima Ctrl+Shift+I.
   • Clique com o botão direito do rato (ou selecione sem soltar) no painel de tarefas para abrir o menu de contexto e selecione Inspecionar ou abra o menu de personalidade e selecione Anexar Depurador. (O menu de personalidade não é suportado no Outlook.)

   Observação

   O novo cliente de ambiente de trabalho do Outlook no Windows (pré-visualização) não suporta o menu de contexto ou o atalho de teclado para aceder às ferramentas de programador do Microsoft Edge. Em vez disso, tem de executar olk.exe --devtools a partir de uma linha de comandos. Para obter mais informações, consulte a secção "Depurar o seu suplemento" de Desenvolver suplementos do Outlook para o novo Outlook no Windows.

3. Abra o separador Origens .

4. Abra o ficheiro que pretende depurar com os seguintes passos.

   1. Na extremidade direita da barra de menus superior da ferramenta, selecione o botão ... e, em seguida, selecione Procurar.
   2. Introduza uma linha de código do ficheiro que pretende depurar na caixa de pesquisa. Deve ser algo que não é provável que esteja em qualquer outro ficheiro.
   3. Selecione o botão atualizar.
   4. Nos resultados da pesquisa, selecione a linha para abrir o ficheiro de código no painel acima dos resultados da pesquisa.

   

5. Para definir um ponto de interrupção, selecione o número de linha da linha no ficheiro de código. Um ponto vermelho aparece junto à linha no ficheiro de código. Na janela do depurador à direita, o ponto de interrupção é registado no menu pendente Pontos de interrupção.

6. Execute funções no suplemento conforme necessário para disparar o ponto de interrupção.

Depurar uma caixa de diálogo num suplemento

Se o seu suplemento utilizar a API de Caixa de Diálogo do Office, a caixa de diálogo é executada num processo separado do painel de tarefas (se aplicável) e a ferramenta tem de ser iniciada a partir desse processo separado. Siga estas etapas.

1. Execute o suplemento.

2. Abra a caixa de diálogo e certifique-se de que tem o foco.

3. Abra as ferramentas de programador do Microsoft Edge (baseado em Chromium) através de um destes métodos:

   • Prima Ctrl+Shift+I ou F12.
   • Clique com o botão direito do rato (ou selecione sem soltar) na caixa de diálogo para abrir o menu de contexto e selecione Inspecionar.

4. Utilize a ferramenta tal como faria para o código num painel de tarefas. Veja Depurar um suplemento do painel de tarefas com ferramentas de programador do Microsoft Edge (baseado em Chromium) anteriormente neste artigo.