Отладка надстроек с помощью средств разработчика в Microsoft Edge (на основе Chromium)

В этой статье показано, как выполнить отладку клиентского кода (JavaScript или TypeScript) надстройки при выполнении следующих условий.

• Вы не можете или не хотите выполнять отладку с помощью средств, встроенных в интегрированную среду разработки; или возникает проблема, которая возникает только при запуске надстройки за пределами интегрированной среды разработки.
• На компьютере используется сочетание версий Windows и Office, которые используют элемент управления WebView2 Edge (на основе Chromium).

Совет

Сведения об отладке с помощью Edge WebView2 (на основе Chromium) в Visual Studio Code см. в статье Отладка надстроек в Windows с помощью Visual Studio Code и Microsoft Edge WebView2 (на основе Chromium).

Сведения об используемом веб-представлении см. в статье Браузеры и элементы управления webview, используемые надстройками Office.

Совет

В последних версиях Office одним из способов определить элемент управления webview, который использует Office, является меню личных данных в любой надстройке, где он доступен. (Меню личных данных не поддерживается в Outlook.) Откройте меню и выберите Сведения для безопасности. В диалоговом окне Сведения о безопасности в Windows среда выполнения сообщает о Microsoft Edge, устаревшая версия Microsoft Edge или Интернет-Обозреватель. Среда выполнения не включена в диалоговое окно в более ранних версиях Office.

Отладка надстройки области задач с помощью средств разработчика Microsoft Edge (на основе Chromium)

Примечание.

Если в надстройке есть команда надстройки, которая выполняет функцию, функция выполняется в скрытом процессе выполнения браузера, из которого невозможно запустить средства разработчика Microsoft Edge (на основе Chromium), поэтому метод, описанный в этой статье, не может использоваться для отладки кода в функции.

1. Загрузите неопубликованное приложение и запустите надстройку.

   Примечание.

   Сведения о загрузке неопубликованных надстроек в Outlook см. в статье Загрузка неопубликованных надстроек Outlook для тестирования.

2. Запустите средства разработчика Microsoft Edge (на основе Chromium) одним из следующих методов:

   • Убедитесь, что область задач надстройки имеет фокус и нажмите клавиши CTRL+SHIFT+I.
   • Щелкните правой кнопкой мыши область задач, чтобы открыть контекстное меню, а затем выберите Проверить или откройте меню личных данных и выберите Подключить отладчик. (Меню личных данных не поддерживается в Outlook.)

   Примечание.

   Новый классический клиент Outlook on Window (предварительная версия) не поддерживает контекстное меню или сочетание клавиш для доступа к средствам разработчика Microsoft Edge. Вместо этого необходимо запустить olk.exe --devtools из командной строки. Дополнительные сведения см. в разделе "Отладка надстройки" статьи Разработка надстроек Outlook для нового Outlook в Windows (предварительная версия).

3. Откройте вкладку Источники .

4. Откройте файл, который требуется отладить, выполнив следующие действия.

   1. В правой части верхней строки меню средства нажмите кнопку ... , а затем выберите Поиск.
   2. Введите строку кода из файла, который требуется отладить, в поле поиска. Это должно быть то, что, скорее всего, не будет в любом другом файле.
   3. Нажмите кнопку обновить.
   4. В результатах поиска выберите строку, чтобы открыть файл кода в области над результатами поиска.

   

5. Чтобы задать точку останова, выберите номер строки в файле кода. Красная точка отображается в строке файла кода. В окне отладчика справа точка останова регистрируется в раскрывающемся списке Точки останова .

6. Выполните функции в надстройке, необходимые для срабатывания точки останова.

Совет

Дополнительные сведения об использовании инструментов см. в статье Обзор средств разработчика Microsoft Edge.

Отладка диалогового окна в надстройке

Если надстройка использует API Office Dialog, диалоговое окно запускается в отдельном процессе от области задач (если таковой имеется), и средство должно быть запущено из этого отдельного процесса. Выполните указанные ниже действия.

1. Запустите надстройку.

2. Откройте диалоговое окно и убедитесь, что в нем есть фокус.

3. Откройте средства разработчика Microsoft Edge (на основе Chromium) одним из следующих способов:

   • Нажмите клавиши CTRL+SHIFT+I или F12.
   • Щелкните правой кнопкой мыши диалоговое окно, чтобы открыть контекстное меню, и выберите пункт Проверить.

4. Используйте средство так же, как и для кода в области задач. См. статью Отладка надстройки области задач с помощью средств разработчика Microsoft Edge (на основе Chromium) ранее в этой статье.