{"id":8233,"date":"2017-08-10T13:23:47","date_gmt":"2017-08-10T20:23:47","guid":{"rendered":"http:\/\/blog.mozilla.org\/addons\/?p=8233"},"modified":"2017-08-21T09:05:03","modified_gmt":"2017-08-21T16:05:03","slug":"webextensions-firefox-56","status":"publish","type":"post","link":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/","title":{"rendered":"WebExtensions in Firefox 56"},"content":{"rendered":"

Firefox 56<\/a> landed in Beta this week, so it\u2019s time for another update on the WebExtensions<\/a> transition. Documentation for the APIs discussed here can be found on MDN Web Docs<\/a>.<\/p>\n

API changes<\/h2>\n

The browsingData<\/code> API can now remove cookies by host<\/a>. The initial implementation of browsingData<\/code> has landed for Android with support for the settings<\/a> and removeCookies<\/code><\/a> APIs.<\/p>\n

The contextMenus<\/code> API also has a few improvements. The text of the link<\/a> is now included in the onClickData<\/code> event and text selection is no longer limited to 150 characters<\/a>. Optional permission requests<\/a> can now also be triggered from context menus.<\/p>\n

An alternative, more general namespace was added, called browser.menus<\/code>. It supports the same API and all existing menu contexts, plus a new one that allows you to add items to the Tools menu<\/a>. You can also provide different icons<\/a> for your menu items. For example:<\/p>\n

browser.menus.create({\r\n  id: \"sort-tabs\",\r\n  title: \"A-Z\",\r\n  contexts: [\"tools_menu\"],\r\n  icons: {\r\n   16: \"icon-16-context-menu.png\",\r\n  },\r\n});\r\n\r\n\"\"<\/a>\r\n\r\n<\/pre>\n
The windows<\/code> API now has the ability to read and preface the title<\/a> of the window object, by passing titlePreface to the window object. This allows extensions to label different windows so they\u2019re easier to distinguish.<\/p>\n
The downloads.open<\/code> API now requires user interaction<\/a> to be called. This mirrors the Chrome API which also requires user interaction. You can now download a blob<\/a> created in a background page.<\/p>\n
The tabs<\/code> API has new printing APIs<\/a>. The tabs.print<\/code><\/a>, tabs.printPreview<\/code><\/a> and tabs.saveAsPDF<\/code><\/a> (not on Mac OS X)<\/a> methods will bring up the respective print dialogs for the page. The tabs.Tab<\/code> object now includes the time the tab was lastAccessed<\/a>.<\/p>\n
The webRequests<\/code> API can now monitor web socket connections<\/a> (but not the messages<\/a>) \u00a0by specifying ws:\/\/<\/code> or wss:\/\/<\/code> in the match pattern. Similarly the match patterns now support moz-extension URLs<\/a>, however this only applies to the same extension. Importantly a HTTP 302 redirection to a moz-extension page will now work<\/a>. For example, this was a common use case for extensions that integrated with OAuth.<\/p>\n
The pageActions<\/code> API can now be shown on a per tab basis on Android<\/a>.<\/p>\n
The privacy<\/code> API gained two new APIs. The privacy.services.passwordSavingEnabled<\/code><\/a> API allows an extension to toggle the preferences that control password saving. The privacy.websites.referrersEnabled<\/code><\/a> API allows an extension to toggle the preferences that control the sending of HTTP Referrer headers.<\/p>\n
A new API to control browserSettings<\/code> has been added with an API to disable the browser\u2019s cache<\/a>. We\u2019ll use this API for similar settings in the future.<\/p>\n
In WebExtensions, we manage the changing of preferences and effects when extensions get uninstalled. This management was applied to chrome_url_overrides<\/a>. The same management now prevents extensions overriding user changed preferences<\/a>.<\/p>\n
The theming<\/code> API gained a reset method<\/a> which can be called after an update to reset Firefox to the default theme.<\/p>\n
The proxy<\/code> API now has the ability to clear out a previously registered proxy.<\/a><\/p>\n
If you\u2019d like store a large amount of data in indexedDB (something we recommend over storage.local<\/code><\/a>) then you can do so by requesting the unlimitedStorage permission. Requesting this will stop indexedDB prompting<\/a> the user for permission to store a large amount of data.<\/p>\n
The management<\/code> API has added get<\/code> and getAll<\/code><\/a> commands. This allows extensions to query existing add-ons to spot any potential conflicts with other content.<\/p>\n
Finally, the devtools.panels.elements.onSelectionChanged<\/code><\/a> API landed and extensions that use the developer tools will find that their panels open faster<\/a>.<\/p>\n
Out of process extensions<\/h2>\n
We first mentioned out of process extensions back in the WebExtensions in Firefox 52<\/a> blog post. They\u2019ve been a project that started back in 2016, but they have now been turned on for Windows users in Firefox 56<\/a>. This is a huge milestone and a lot of work from the team.<\/p>\n
This means that all the WebExtensions will run in their own process (that\u2019s one process for all extensions). This has many advantages, but chief among them are \u00a0performance, security, and crash handling. For example, a crash in a WebExtension will no longer bring down Firefox. Content scripts from WebExtensions are still handled by the content process.<\/p>\n
With the new WebExtensions architecture this change was completed with zero changes by extension developers, a significant improvement over the legacy extension environment.<\/p>\n
There are some remaining bugs on Linux and OS X that prevent us from enabling it there, but we hope to enable those in the coming releases.<\/p>\n
Along with measuring the performance of out of process, we\u2019ve added in multiple telemetry signals<\/a> to measure the performance of WebExtensions. \u00a0For example, it was recently found that storage.local.set<\/a> was slow. With some improvements, we\u2019ve seen a significant performance boost<\/a> from a median of over 200ms down to around 25ms:<\/p>\n
\"\"<\/a><\/p>\n
These telemetry measures conform to the standard Mozilla telemetry guidelines<\/a>.<\/p>\n
about:debugging<\/h2>\n
The about:debugging page got some more improvements:<\/p>\n
\"\"<\/a><\/p>\n
The add-on ID<\/a> has been added to the page. If there\u2019s a warning about processing the add-on, that will now be shown next to the extension<\/a>. Perhaps most useful to those working on their first add-on, if an add-on fails to load because of a problem, then no problem\u2014there\u2019s now an easy \u201cretry\u201d button<\/a> for you to press:<\/p>\n
\"\"<\/a><\/p>\n
Contributors<\/h2>\n
Thank you once again to our many contributors for this release, especially our volunteers including: Cameron Kaiser<\/a>, dw-dev<\/a>, Giorgio Maone<\/a>, Swapnesh Kumar Sahoo<\/a>, Timothy Johnson<\/a>, Tushar Saini<\/a> and Tomislav Jovanovic<\/a>.<\/p>\n
Update<\/strong>: improved the quality of the image for context menus and removed the line about “twice as long…”.<\/p>\n","protected":false},"excerpt":{"rendered":"
Firefox 56 landed in Beta this week, so it\u2019s time for another update on the WebExtensions transition. Documentation for the APIs discussed here can be found on MDN Web Docs. … Read more<\/a><\/p>\n","protected":false},"author":271,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[278886],"tags":[],"yoast_head":"\nWebExtensions in Firefox 56 - Mozilla Add-ons Community Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Andy McKay\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/\",\"name\":\"WebExtensions in Firefox 56 - Mozilla Add-ons Community Blog\",\"isPartOf\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/08\/Screenshot-2017-08-10-19.45.07.png\",\"datePublished\":\"2017-08-10T20:23:47+00:00\",\"dateModified\":\"2017-08-21T16:05:03+00:00\",\"author\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/7e1881db0e8a23a4a06695f8a0efd6b8\"},\"breadcrumb\":{\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#primaryimage\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/08\/Screenshot-2017-08-10-19.45.07.png\",\"contentUrl\":\"https:\/\/blog.mozilla.org\/addons\/files\/2017\/08\/Screenshot-2017-08-10-19.45.07.png\",\"width\":676,\"height\":400},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/blog.mozilla.org\/addons\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"WebExtensions in Firefox 56\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#website\",\"url\":\"https:\/\/blog.mozilla.org\/addons\/\",\"name\":\"Mozilla Add-ons Community Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog.mozilla.org\/addons\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/7e1881db0e8a23a4a06695f8a0efd6b8\",\"name\":\"Andy McKay\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/ad304e7a7d4f6fba05a81b10810fe6fd?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/ad304e7a7d4f6fba05a81b10810fe6fd?s=96&d=mm&r=g\",\"caption\":\"Andy McKay\"},\"description\":\"Andy is an Engineering Manager at Mozilla. As a Canadian he tweets and blogs about curling, skiing, politics, maple syrup, bears and all things from the great white north.\",\"sameAs\":[\"http:\/\/mckay.pub\",\"https:\/\/x.com\/andymckay\"],\"url\":\"https:\/\/blog.mozilla.org\/addons\/author\/amckaymozilla-com\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"WebExtensions in Firefox 56 - Mozilla Add-ons Community Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/","twitter_misc":{"Written by":"Andy McKay","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/","url":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/","name":"WebExtensions in Firefox 56 - Mozilla Add-ons Community Blog","isPartOf":{"@id":"https:\/\/blog.mozilla.org\/addons\/#website"},"primaryImageOfPage":{"@id":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#primaryimage"},"image":{"@id":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#primaryimage"},"thumbnailUrl":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/08\/Screenshot-2017-08-10-19.45.07.png","datePublished":"2017-08-10T20:23:47+00:00","dateModified":"2017-08-21T16:05:03+00:00","author":{"@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/7e1881db0e8a23a4a06695f8a0efd6b8"},"breadcrumb":{"@id":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#primaryimage","url":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/08\/Screenshot-2017-08-10-19.45.07.png","contentUrl":"https:\/\/blog.mozilla.org\/addons\/files\/2017\/08\/Screenshot-2017-08-10-19.45.07.png","width":676,"height":400},{"@type":"BreadcrumbList","@id":"https:\/\/blog.mozilla.org\/addons\/2017\/08\/10\/webextensions-firefox-56\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/blog.mozilla.org\/addons\/"},{"@type":"ListItem","position":2,"name":"WebExtensions in Firefox 56"}]},{"@type":"WebSite","@id":"https:\/\/blog.mozilla.org\/addons\/#website","url":"https:\/\/blog.mozilla.org\/addons\/","name":"Mozilla Add-ons Community Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.mozilla.org\/addons\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/7e1881db0e8a23a4a06695f8a0efd6b8","name":"Andy McKay","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.mozilla.org\/addons\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/ad304e7a7d4f6fba05a81b10810fe6fd?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/ad304e7a7d4f6fba05a81b10810fe6fd?s=96&d=mm&r=g","caption":"Andy McKay"},"description":"Andy is an Engineering Manager at Mozilla. As a Canadian he tweets and blogs about curling, skiing, politics, maple syrup, bears and all things from the great white north.","sameAs":["http:\/\/mckay.pub","https:\/\/x.com\/andymckay"],"url":"https:\/\/blog.mozilla.org\/addons\/author\/amckaymozilla-com\/"}]}},"_links":{"self":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts\/8233"}],"collection":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/users\/271"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/comments?post=8233"}],"version-history":[{"count":0,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/posts\/8233\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/media?parent=8233"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/categories?post=8233"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.mozilla.org\/addons\/wp-json\/wp\/v2\/tags?post=8233"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}