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

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

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

  • Операционная система компьютера.
  • Выполняется ли надстройка в Office в Интернете, в Office, скачанном из подписки Microsoft 365, или в Office 2013 с бессрочным сроком действия или более поздней версии.
  • В бессрочных версиях Office в Windows, независимо от того, работает ли надстройка в варианте "розничная" или "корпоративная лицензия".

Примечание.

В этой статье предполагается, что надстройка выполняется в документе, который не защищен с помощью windows Information Protection (WIP). Для документов, защищенных WIP, существуют некоторые исключения из сведений, приведенных в этой статье. Дополнительные сведения см. в статье Документы, защищенные WIP.

Важно!

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

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

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

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

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

Платформы, отличные от Windows

Для этих платформ только платформа определяет используемый браузер.

ОС Версия Office Браузер
любой Office в Интернете Браузер, в котором открыт Office.
(Но обратите внимание, что Office в Интернете не открывается в Internet Explorer.
При попытке сделать это откроется Office в Интернете в Edge.)
Mac любой Safari с WKWebView
iOS любой Safari с WKWebView
Android любой Chrome

Бессрочные версии Office в Windows

Для бессрочных версий Office в Windows используемый браузер определяется версией Office, независимо от того, является ли лицензия розничной или корпоративной, а также установлена ли edge WebView2 (на основе Chromium). Версия Windows не имеет значения, но обратите внимание, что веб-надстройки Office не поддерживаются в версиях, предшествующих Windows 7, и Office 2021 не поддерживается в версиях, предшествующих Windows 10.

Чтобы определить, является ли Office 2016 или Office 2019 розничным или корпоративным, используйте формат версии и номера сборки Office. (Для Office 2013 и Office 2021 разница между корпоративной лицензией и розничной лицензией не имеет значения.)

  • Розничная торговля. Как для Office 2016, так и для 2019 формат имеет формат , оканчивающийся YYMM (xxxxx.xxxxxx)двумя блоками из пяти цифр, например 2206 (Build 15330.20264.
  • С корпоративной лицензией:
    • Для Office 2016 формат имеет формат , заканчивающийся 16.0.xxxx.xxxxxдвумя блоками из четырех цифр, например 16.0.5197.1000.
    • Для Office 2019 формат имеет формат , заканчивающийся 1808 (xxxxx.xxxxxx)двумя блоками из пяти цифр, например 1808 (Build 10388.20027). Обратите внимание, что год и месяц всегда 1808являются .
Версия Office Розничная и корпоративная лицензия Edge WebView2 (на основе Chromium) установлен? Браузер
Office 2013 Всё равно Всё равно Internet Explorer 11
Office 2016 Корпоративная лицензия Всё равно Internet Explorer 11
Office 2019 Корпоративная лицензия Всё равно Internet Explorer 11
Office 2016 — Office 2019 Розничная торговля Нет Microsoft Edge1, 2 с исходным WebView (EdgeHTML)
Если Edge не установлен, используется Internet Explorer 11.
Office 2016 — Office 2019 Розничная торговля Да3 Microsoft Edge1 с WebView2 (на основе Chromium)
Office 2021 Всё равно Да3 Microsoft Edge1 с WebView2 (на основе Chromium)

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

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

3 В версиях Windows до Windows 11 необходимо установить элемент управления WebView2, чтобы Office смог внедрить его. Он устанавливается с бессрочной Office 2021 или более поздней версии, но не устанавливается автоматически с Microsoft Edge. Если у вас есть более ранняя версия Office с бессрочной лицензией, используйте инструкции по установке элемента управления в Microsoft Edge WebView2 / Внедрение веб-содержимого ... с Microsoft Edge WebView2.

Версии Office для Windows по подписке на Microsoft 365

Для Office в Windows по подписке используемый браузер определяется операционной системой, версией Office и установкой Edge WebView2 (на основе Chromium).

ОС Версия Office Edge WebView2 (на основе Chromium) установлен? Браузер
Windows 7 Microsoft 365 Всё равно Internet Explorer 11
Windows 8.1,
Windows 10 версии < 1903
Microsoft 365 Нет Internet Explorer 11
Windows 10 версии >= 1903,
Windows 11
Microsoft 365 ver. < 16.0.116292 Всё равно Internet Explorer 11
Windows 10 версии >= 1903,
Windows 11
Microsoft 365 ver. >= 16.0.11629 И< 16.0.13530.204242 Всё равно Microsoft Edge1, 3 с оригинальным WebView (EdgeHTML)
Windows 10 версии >= 1903,
Окно 11
Microsoft 365 ver. >= 16.0.13530.204242 Нет Microsoft Edge1, 3 с оригинальным WebView (EdgeHTML)
Windows 8.1
Windows 10,
Windows 11
Microsoft 365 ver. >= 16.0.13530.204242 Да4 Microsoft Edge1 с WebView2 (на основе Chromium)

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

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

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

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

Работа с Internet Explorer

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

  • Напишите код в ECMAScript 2015 (также называемом ES6) или более поздней версии JavaScript или в TypeScript, а затем скомпилируйте код в ES5 JavaScript с помощью компилятора, например babel или tsc.
  • Напишите в ECMAScript 2015 или более поздней версии JavaScript, но также загрузите библиотеку polyfill , например 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. Обходной путь — создать простое веб-приложение, которое скачивает BLOB-объекты в виде PDF-файлов. В надстройке Office.context.ui.openBrowserWindow(url) вызовите метод и передайте URL-адрес веб-приложения. Откроется веб-приложение в окне браузера за пределами Office.

Документы, защищенные WIP

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

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

  1. Откройте файл.
  2. Перейдите на вкладку Файл на ленте.
  3. Выберите Сведения.
  4. В левом верхнем углу страницы Сведений сразу под именем файла документ с поддержкой WIP будет иметь значок портфеля, за которым следует управляемый по труду (...).

См. также