Поделиться через

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

  • Статья

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

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

Совет

Сведения об отладке с помощью 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 или Internet Explorer. Среда выполнения не включена в диалоговое окно в более ранних версиях 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) ранее в этой статье.