Браузеры, используемые надстройками Office

Office надстройки — это веб-приложения, которые отображаются с помощью iFrame при запуске в Office в Интернете. В Office для настольных и мобильных клиентов надстройки Office используют встроенный элемент управления браузером (также называемый веб-представлением). Для запуска JavaScript надстройкам также требуется модуль JavaScript. Встроенный браузер и обработчик предоставляются браузером, установленным на компьютере пользователя.

Используемый браузер зависит от указанных ниже факторов.

  • Операционная система компьютера.
  • Работает ли надстройка в Office в Интернете, Microsoft 365 или без подписки Office 2013 или более поздней версии.

Важно!

Internet Explorer по-прежнему используется в Office надстройки

Некоторые сочетания платформ и Office версий, в том числе версии с однофакторной покупкой до Office 2019, по-прежнему используют элемент управления webview, который поставляется с Internet Explorer 11 для размещения надстроек, как описано в этой статье. Рекомендуется (но не обязательно) продолжать поддерживать эти сочетания, по крайней мере минимально, предоставляя пользователям надстройки корректное сообщение об ошибке при запуске надстройки в веб-представлении Internet Explorer. Учитывайте следующие дополнительные моменты:

  • Office в Интернете больше не открывается в Internet Explorer. Следовательно, AppSource больше не тестирует надстройки в Office в Интернете в качестве браузера.
  • AppSource по-прежнему проверяет комбинации платформы и классических версий Office, использующих Internet Explorer, однако выдано предупреждение только в том случае, если надстройка не поддерживает Internet Explorer; AppSource не отклоняет надстройку.
  • Средство Script Lab больше не поддерживает Internet Explorer.

Дополнительные сведения о поддержке Internet Explorer и настройке корректного сообщения об ошибке в надстройке см. в разделе "Поддержка Internet Explorer 11".

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

ОС Версия Office Edge WebView2 (Chromium на основе) установлен? Браузер
любой Office в Интернете Неприменимо Браузер, в котором открыт Office.
(Обратите внимание, Office в Интернете не будет открываться в Internet Explorer.
Попытка сделать это откроется Office в Интернете Edge.)
Mac любой Неприменимо Safari с WKWebView
iOS любой Неприменимо Safari с WKWebView
Android любой Неприменимо Chrome.
Windows 7, 8.1, 10, 11 с 2013 Office 2013 по Office 2019 Всё равно Internet Explorer 11
Windows 10, 11 не из подписки Office 2021 или более поздней версии Да Microsoft Edge 1 с WebView2 (Chromium на основе)
Windows 7 Microsoft 365 Всё равно Internet Explorer 11
Windows 8.1,
Windows 10 ver. <  1903
Microsoft 365 Нет Internet Explorer 11
Windows 10 ver. >=  1903,
Windows 11
Microsoft 365 ver. <  16.0.116292 Всё равно Internet Explorer 11
Windows 10 ver. >=  1903,
Windows 11
Microsoft 365 ver. >=  16.0.11629AND16.0.13530.204242   Всё равно Microsoft Edge 1, 3 с исходным WebView (EdgeHTML)
Windows 10 ver. >=  1903,
Окно 11
Microsoft 365 ver. >=  16.0.13530.204242 Нет Microsoft Edge 1, 3 с исходным WebView (EdgeHTML)
Windows 8.1
Windows 10,
Windows 11
Microsoft 365 ver. >=  16.0.13530.204242 Да4 Microsoft Edge 1 с WebView2 (Chromium на основе)

1 При Microsoft Edge используется Windows экранный диктор (иногда называемая средством чтения с экрана) <title> считывает тег на странице, которая открывается в области задач. Когда используется Internet Explorer 11, экранный диктор читает панель заголовка области задач, полученный от значения <DisplayName> в манифесте надстройки.

2. Дополнительные сведения см. на странице журнала обновлений и способах поиска Office версии клиента и канала обновления.

3. Если надстройка <Runtimes> включает элемент в манифест, она не будет использовать Microsoft Edge с исходным WebView (EdgeHTML). Если выполняются условия Microsoft Edge webView2 (на Chromium webView2), надстройка использует этот браузер. В противном случае он использует Internet Explorer 11 независимо Windows или Microsoft 365 версии. Дополнительные сведения см. в статье Runtimes.

4 В Windows до Windows 11 необходимо установить элемент управления WebView2, чтобы Office его можно было внедрить. Он устанавливается с Microsoft 365 версии 2101 или более поздней версии и с однофакторной покупкой Office 2021 или более поздней версии, но не устанавливается автоматически с Microsoft Edge. Если у вас есть более раннюю версию Microsoft 365 или Office, следуйте инструкциям по установке элемента управления на веб-сайте Microsoft Edge WebView2 / Внедрение веб-содержимого... с Microsoft Edge WebView2. В Microsoft 365 сборках до версии 16.0.14326.xxxxx **** dword:00000001необходимо также создать раздел реестраHKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2и задать его значение .

Важно!

Internet Explorer 11 не поддерживает версии JavaScript, более поздние, чем ES5. Если у любого из пользователей надстройки есть платформы, использующие Internet Explorer 11, то для использования синтаксиса и функций ECMAScript 2015 или более поздней версии у вас есть два варианта.

  • Напишите код в ECMAScript 2015 (также называемом ES6) или более поздней версии JavaScript или в TypeScript, а затем скомпилируете код в ES5 JavaScript с помощью компилятора, такого как pythonel или tsc.
  • Написание в ECMAScript 2015 или более поздней версии JavaScript, но также загрузка библиотеки полизаполнения, например core-js, которая позволяет IE выполнять код.

Дополнительные сведения об этих параметрах см. в разделе "Поддержка Internet Explorer 11".

Кроме того, Internet Explorer 11 не поддерживает некоторые элементы HTML5, в частности медиа, запись и местоположение. Дополнительные сведения см. в статье "Определение во время выполнения", если надстройка запущена в Internet Explorer.

Устранение неполадок Microsoft Edge проблем

Рабочие роли службы не работают

Office надстройки не поддерживают рабочие роли служб при использовании исходного Microsoft Edge WebView, EdgeHTML. Они поддерживаются в Chromium Edge WebView2.

В области задач не отображается полоса прокрутки

По умолчанию полосы прокрутки в Microsoft Edge скрыты до наведения указателя мыши. Чтобы полоса прокрутки отображалась постоянно, стиль CSS, применяемый к элементу <body> страниц в области задач, должен содержать свойство -ms-overflow-style со значением scrollbar.

При отладке с помощью Microsoft Edge DevTools надстройка аварийно завершает работу или перезагружается

Настроенные точки останова в Microsoft Edge DevTools приложение Office может воспринимать как зависание надстройки. В этом случае выполняется автоматическая перезагрузка надстройки. Чтобы избежать этого, добавьте следующий раздел реестра и значение на компьютере разработчика: [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000.

При попытке открытия надстройки появляется сообщение "ОШИБКА НАДСТРОЙКИ. Не удается открыть эту надстройку из localhost"

Одной из известных причин является требование Microsoft Edge, чтобы для localhost предоставлялось исключение замыкания на себя. Следуйте инструкциям из статьи Не удается открыть надстройку из localhost.

Получение ошибок при попытке скачать PDF-файл

Непосредственное скачивание больших двоичных объектов в виде PDF-файлов в надстройке не поддерживается, если браузером является Edge. Решением является создание простого веб-приложения, которое скачивает большие двоичные объекты в виде PDF-файлов. В надстройке вызовите метод Office.context.ui.openBrowserWindow(url) и передайте URL-адрес веб-приложения. Откроется веб-приложение в окне браузера за пределами Office.

См. также