Отладка функций инициализации и onReady

Примечание.

В этой статье предполагается, что вы знакомы с инициализацией надстройки Office.

Парадокс отладки функций Office.initialize и Office.onReady заключается в том, что отладчик может подключаться только к выполняемому процессу, но эти функции выполняются сразу же при запуске процесса выполнения надстройки, прежде чем отладчик сможет подключиться. В большинстве случаев перезапуск надстройки после присоединения отладчика не помогает, так как перезапуск надстройки закрывает исходный процесс выполнения и подключенный отладчик и запускает новый процесс, к которому не подключен отладчик.

К счастью, существует два способа отладки этих функций, описанных в следующих разделах.

Отладка с помощью Office в Интернете

Чтобы выполнить отладку с помощью Office в Интернете, выполните следующие действия.

1. Загрузите и запустите надстройку в Office в Интернете. Обычно это делается путем открытия области задач надстройки или выполнения команды функции. Надстройка выполняется в общем процессе браузера, а не в отдельном процессе, как в классической версии Office.
2. Откройте средства разработчика браузера. Обычно это можно сделать, нажав клавишу F12. Отладчик в средствах подключается к процессу браузера.
3. Примените точки останова по мере необходимости к коду Office.initialize в функции или Office.onReady .
4. Перезапустите область задач надстройки или команду функции , как это было на шаге 1. Это действие не закрывает процесс браузера или отладчик. Функция Office.initialize или Office.onReady снова запускается, и обработка останавливается в точках останова.

Совет

Дополнительные сведения см. в разделе Отладка надстроек в Office в Интернете.

Отладка с помощью Office в Windows

Чтобы отладить последовательность инициализации надстройки, настройте среду так, чтобы средства разработчика Microsoft WebView2 автоматически открывались при запуске надстройки.

1. Закройте приложение Office, в котором планируется выполнить отладку надстройки.
2. Задайте переменную WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS среды, чтобы включить значение --auto-open-devtools-for-tabs.
3. Откройте приложение Office.
4. Запустите надстройку.
5. Средства разработчика Microsoft Edge должны открыться автоматически. Используйте средство так же, как и при отладке области задач, как указано в разделе Отладка надстройки области задач с помощью средств разработчика Microsoft Edge.

Примечание.

Вы можете увидеть другие экземпляры средства разработчика Microsoft Edge, так как эта переменная среды повлияет на все экземпляры WebView2 в вашей системе.

См. также

• Среды выполнения в надстройках Office