{"id":2911,"date":"2019-05-20T22:18:40","date_gmt":"2019-05-21T05:18:40","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=2911"},"modified":"2021-10-18T11:08:12","modified_gmt":"2021-10-18T18:08:12","slug":"microsoft-edge-webview-for-office-add-ins","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/microsoft-edge-webview-for-office-add-ins\/","title":{"rendered":"Microsoft Edge WebView for Office Add-ins"},"content":{"rendered":"<p><img decoding=\"async\" class=\"alignnone wp-image-3027\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/webview-1024x572.png\" alt=\"Updated WebView for Office Add-ins. Improved compatibility with web standards.\" width=\"768\" height=\"429\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/webview-1024x572.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/webview-300x168.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/webview-768x429.png 768w\" sizes=\"(max-width: 768px) 100vw, 768px\" \/><\/p>\n<p>Since the creation of the Office Add-ins framework, add-ins running in Office on Windows used a web viewer control that leveraged elements of Internet Explorer 11. While it was cutting edge at the time, web development standards have continued to evolve.<\/p>\n<p>As <a href=\"https:\/\/developer.microsoft.com\/office\/blogs\/office-extensibility-build-2019\/\">we announced at Build 2019<\/a>, to improve our support for web standards we are moving to an updated WebView control that is based on the current version of Microsoft Edge.<\/p>\n<p>Beginning with Office 365 version 16.0.11629 and Windows 10 version 1903, Office Add-ins running on Office 365 for Windows will use a Microsoft Edge WebView as the runtime.<\/p>\n<p>The Microsoft Edge WebView performs much better than Internet Explorer and features enhanced compliance with modern browser standards including support of the full set of HTML 5 and ECMAScript 2015+.<\/p>\n<p>This change does not affect:<\/p>\n<ul>\n<li>Non-Windows Office versions, such as Office for Mac, iOS, Android, and Office Online. For information about which browser\u2019s web viewer is used on these platforms and operating systems, see <a href=\"https:\/\/docs.microsoft.com\/office\/dev\/add-ins\/concepts\/web-viewers-used-by-office-web-add-ins\" target=\"_blank\" rel=\"noopener noreferrer\">Web viewers used by Office Add-ins<\/a>.<\/li>\n<li>Non-subscription versions of Office for Windows. These will continue to use Internet Explorer 11 as the web viewer.<\/li>\n<li>Office running on versions of Windows 10 lower than 1903. These will also continue to use Internet Explorer 11.<\/li>\n<li>Versions of Office lower than 16.0.11629. These will also continue to use Internet Explorer 11.<\/li>\n<\/ul>\n<p>At Microsoft Build 2019, the Microsoft Edge team also announced new capabilities for the <a href=\"https:\/\/blogs.windows.com\/msedgedev\/2019\/05\/06\/edge-chromium-build-2019-pwa-ie-mode-devtools\/#TzrpLCIAkg65MoW1.97\">next version of Microsoft Edge\u00a0, built on the Chromium open source project<\/a>. We\u2019re continuing to partner with the Microsoft Edge team to bring improved support for web standards to the Office add-ins platform.<\/p>\n<h4>General Availability of the new versions of Windows and Office 365<\/h4>\n<ul>\n<li>Office 365, version 16.0.11629 will be the next Office 365 monthly update.<\/li>\n<li>Windows 10, version 1903 will be released in May, 2019.<\/li>\n<\/ul>\n<h4>Notes for Office Add-in Developers<\/h4>\n<ul>\n<li>We recommend that you download the <a href=\"https:\/\/www.microsoft.com\/en-us\/p\/microsoft-edge-devtools-preview\/9mzbfrmz0mnj?activetab=pivot%3Aoverviewtab\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft Edge DevTools Preview<\/a> for debugging.<\/li>\n<li>If you haven\u2019t used JavaScript later than ES5 in the past because Internet Explorer did not support it, you may want to start using ECMAScript 2015 or later. For your add-in to still run on Windows and Office versions that do not use the Microsoft Edge viewer, you will need to either transpile your JavaScript to ES5 or use a polyfill.<\/li>\n<li>When loading an Office add-in from https:\/\/localhost or when using the <a href=\"https:\/\/www.telerik.com\/fiddler\" target=\"_blank\" rel=\"noopener noreferrer\">Fiddler<\/a> tool, you may see an error stating that a problem occurred while trying to reach your add-in. To fix this, follow either of these steps to add a local loopback exemption to \u201cDesktop App Web Viewer\u201d:\n<ul>\n<li>Open a command prompt as Administrator and run the following command: <strong>CheckNetIsolation LoopbackExempt -a -n=&#8221;microsoft.win32webviewhost_cw5n1h2txyewy&#8221;\u00a0<\/strong><\/li>\n<li>Using Fiddler: Select <strong>Tools &gt; Win8 Loopback Exemptions<\/strong> and add an exemption to \u201cDesktop App Web Viewer.\u201d<\/li>\n<\/ul>\n<\/li>\n<li>On Office builds before 1906 11727, a call of <a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/office\/office.document?view=office-js#setselecteddataasync-data--callback-\">Office.Document.setSelectedDataAsync()<\/a> will fail if all of the following conditions are met:\n<ul>\n<li>The data parameter is type <a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/office\/office.tabledata?view=office-js\">TableData<\/a>.<\/li>\n<li>The TableData object has a header row, but no data rows.<\/li>\n<li>The TableData object has more than one column.<\/li>\n<\/ul>\n<\/li>\n<li>Please note that Service Workers are not supported on Microsoft Edge WebView for Office add-ins. Please see <a href=\"https:\/\/docs.microsoft.com\/en-us\/office\/dev\/add-ins\/overview\/office-add-ins\" target=\"_blank\" rel=\"noopener noreferrer\">here<\/a> for the latest supported features on the Edge WebView control. We are working hard to bring the new Chromium based Edge WebView2 to the Office add-ins platform, which we expect will support Service Workers.<\/li>\n<li>If you find a bug, report it as an issue at <a href=\"https:\/\/github.com\/OfficeDev\/office-js\/issues\/new\" target=\"_blank\" rel=\"noopener noreferrer\">OfficeDev\/office-js<\/a>.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Beginning with Office 365 version 16.0.11629 and the first 2019 Windows 10 update, Office Add-ins running on Office 365 for Windows will use an Edge WebView as the runtime.<\/p>\n","protected":false},"author":69076,"featured_media":3035,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[11],"tags":[132],"class_list":["post-2911","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-office-add-ins","tag-add-ins"],"acf":[],"blog_post_summary":"<p>Beginning with Office 365 version 16.0.11629 and the first 2019 Windows 10 update, Office Add-ins running on Office 365 for Windows will use an Edge WebView as the runtime.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/2911","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69076"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=2911"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/2911\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/3035"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=2911"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=2911"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=2911"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}