Firefox 57 (Quantum) for developers

{{FirefoxSidebar}} 

This article provides information about the changes in Firefox 57 (a.k.a. Firefox Quantum) that will affect developers. Firefox 57 was released on November 14, 2017.

Firefox 57 === Firefox Quantum

Firefox 57 has been given the release name Quantum, after the Firefox Quantum engineering project that has aimed to rebuild Firefox from the ground up, bringing with it major performance, stability, and visual improvements. This is the first version of Firefox to ship some of these improvements, so we wanted to mark the occasion.

[!NOTE] To read more about the Quantum features in this release, see Firefox Quantum Developer Edition: the fastest Firefox ever with Photon UI and better tooling by Dan Callahan.

Firefox’s new parallel CSS engine — also known as Quantum CSS or Stylo — is enabled by default in Firefox 57 for desktop, with Mobile versions of Firefox to follow later on. Developers shouldn’t notice anything significantly different, aside from a whole host of performance improvements. There are however a number of minor functional differences in Stylo, implemented to fix non-standard Gecko behavior that should be eliminated. We will report on such differences on reference pages and in the release notes as appropriate (see Quantum CSS notes).

Changes for Web developers

Developer Tools

No changes.

HTML

• The date and time {{htmlelement("input")}}  types are now enabled in all builds (Firefox bug 1399036).

CSS

• The minimal-ui and standalone values of the display-mode media query are now supported (Firefox bug 1369815). See also the Web app manifest display field.
• The grid-row-gap and grid-column-gap properties are no longer reset by the {{CSSxRef("grid")}}  shorthand (Firefox bug 1387410).
• The layout.css.clip-path-shapes.enabled preference has been removed (Firefox bug 1399767). This preference allowed disabling the {{CSSxRef("<basic-shape>")}}  support in {{CSSxRef("clip-path")}} . This support was shipped in Firefox 54 and can no longer be disabled.

Quantum CSS notes

Following bugs have been fixed in Quantum:

• Radial gradient values like radial-gradient(circle gold,red) will work in the old Gecko style system, even though they shouldn’t because of the missing comma between circle and gold (Firefox bug 1383323).
• When you animate an offscreen element onscreen but specify a delay, Gecko does not repaint on some platforms, e.g. Windows (Firefox bug 1383239).
• In Gecko, {{htmlelement("details")}}  elements can’t be made open by default using the open attribute if they have an {{CSSxRef("animation")}}  active on them (Firefox bug 1382124).
• In Gecko, {{CSSxRef("transition", "transitions")}}  will not work when transitioning from a {{CSSxRef("text-shadow")}}  with a color specified to a text-shadow without a color specified (Firefox bug 726550).
• In Gecko, cancelling a filling animation (e.g. with animation-fill-mode: forwards set) can trigger a transition set on the same element, although only once (see Firefox bug 1192592 and these test cases for more information). In general declarative animations should not trigger transitions.
• Animations using em units are not affected by changes to the {{CSSxRef("font-size")}}  on the animated element’s parent in Gecko, whereas they should be (Firefox bug 1254424).
• Gecko also deals with font-size inheritance differently from Quantum CSS, meaning that for some language settings inherited font sizes end up being smaller than expected (see Firefox bug 1391341).
• Gecko reuses the same mechanism used when parsing a url-token when parsing the domain() or url-prefix() URL matching functions for a {{CSSxRef("@document", "@-moz-document")}}  rule. Quantum CSS does not use the same mechanism and it does not consider tokens invalid when they contain brackets or quotes (Firefox bug 1362333).
• In Gecko, when you set a system font as the value of a canvas 2D context’s {{DOMxRef("CanvasRenderingContext2D.font", "font")}}  (e.g. menu), getting the font value fails to return the expected font (it returns nothing). This has been fixed in Quantum. (Firefox bug 1374885).
• In Gecko, when you create a detached subtree (e.g. a {{htmlelement("div")}}  created using {{DOMxRef("Document.createElement","createElement()")}}  that is not yet inserted into the DOM), the subtree’s root element is set as a block-level element. In Quantum CSS this is set as inline, as per spec (Firefox bug 1374994).
• In Gecko, {{CSSxRef("calc", "calc()")}}  expressions are rejected — causing the value to be invalid — when used as the radius component of a {{CSSxRef("gradient/radial-gradient")}}  function (Firefox bug 1376019).
• In Gecko, calc(1*2*3) is not parsed successfully; Quantum CSS fixes this (Firefox bug 1379467).
• In Quantum CSS, calc() is supported everywhere that the spec explains it should be (Firefox bug 1350857). In Gecko it is not.
• Gecko has a bug whereby the {{CSSxRef("::before")}}  and {{CSSxRef("::after")}}  pseudo-elements are still generated even if the {{CSSxRef("content")}}  property value is set to normal or none. As per spec, they shouldn’t be (Firefox bug 1387931).
• Another Gecko bug means that the {{CSSxRef("background-position")}}  property can’t be transitioned between two values containing different numbers of {{CSSxRef("<position>")}}  values, for example background-position: 10px 10px; and background-position: 20px 20px, 30px 30px; (see Firefox bug 1390446).

SVG

No changes.

JavaScript

• The non-standard for each...in loop, originally part of ECMAScript for XML (E4X), has been removed. Please use {{JSxRef("Statements/for...of", "for...of")}}  instead. (Firefox bug 1083470).
• The Object.prototype.watch() and Object.prototype.unwatch() methods are deprecated, will now throw a warning when used, and will be removed soon (Firefox bug 934669).
• The non-standard Iterator and StopIteration objects as well as the legacy iteration protocol have been removed (Firefox bug 1098412).
• Async generator is now enabled (Firefox bug 1352312).
• for await (… of …) syntax is now enabled (Firefox bug 1352312).

APIs

New APIs

• The {{DOMxRef("PerformanceObserver")}}  API is now enabled by default (Firefox bug 1386021).
• The {{DOMxRef("AbortController")}}  and {{DOMxRef("AbortSignal")}}  interfaces (known as the Abort API) have been added, allowing DOM requests (such as fetch requests) to be aborted if desired (Firefox bug 1378342).
• [2] The Storage API is implemented and enabled by default (Firefox bug 1399038).

DOM

• The {{DOMxRef("Selection.type")}}  property of the Selection API is now implemented (Firefox bug 1359157).
• {{DOMxRef("Document.createEvent", "Document.createEvent('FocusEvent')")}}  is now supported (Firefox bug 1388069).
• The files property of the {{DOMxRef("HTMLInputElement")}}  interface is now settable (Firefox bug 1384030).
• The HTMLDocument.getSelection() method has been moved to the {{DOMxRef("Document/getSelection","Document")}}  interface so it is available to XML documents (Firefox bug 718711).
• The messageerror event is now implemented, and can have code run in response to it firing via event handlers implemented on message targets — see the messageerror event of {{DOMxRef("MessagePort.messageerror_event", "MessagePort")}} , {{DOMxRef("DedicatedWorkerGlobalScope.messageerror_event", "DedicatedWorkerGlobalScope")}} , {{DOMxRef("Worker.messageerror_event", "Worker")}} , {{DOMxRef("BroadcastChannel.messageerror_event", "BroadcastChannel")}} , and {{DOMxRef("Window.messageerror_event", "Window")}}  (Firefox bug 1359017).
• When {{DOMxRef("Headers")}}  values are iterated over, they are automatically sorted in lexicographical order, and values from duplicate header names are combined (Firefox bug 1396848).

DOM events

No changes.

Media and WebRTC

• Support for messages of arbitrary size (up to 1GiB, although 256kiB is more interoperable) is now supported on {{DOMxRef("RTCDataChannel")}}  through use of the end-of-record (EOR) flag on SCTP messages. See Understanding message size limits for more information (Firefox bug 979417).

  [!NOTE] Because Firefox doesn’t yet support the SCTP ndata protocol that provides the ability to interleave SCTP messages from multiple sources, sending large data objects can cause significant delays on all other SCTP traffic. See Firefox bug 1381145 to track progress on implementing and deploying ndata support in Firefox.

• The {{DOMxRef("RTCDataChannel.send()")}}  method can now throw a TypeError exception if the size of the message you’re trying to send is not compatible with the receiving {{Glossary("user agent")}}  (this is implemented as part of Firefox bug 979417).

• The MediaStream Recording API has been updated so that {{domxref("MediaRecorder/error_event", "error")}}  events sent to report problems that occur while recording are now of type {{DOMxRef("MediaRecorderErrorEvent")}}  rather than being generic events.

• Updated the documentation around {{DOMxRef("OfflineAudioContext")}}  since its constructor’s inputs can now be specified in an object rather than as a list of parameters (Firefox bug 1388591).

• The Web Audio API now properly supports multi-channel output (Firefox bug 1378070).

Security

• resource:// URLs no longer leak information (Firefox bug 863246)
• Data URLs are now treated as unique opaque origins, rather than inheriting the origin of the settings object responsible for the navigation (Firefox bug 1324406).

Plugins

No changes.

Other

• Firefox headless mode now includes a -screenshot flag that allows you to take website screenshots directly from the command line (Firefox bug 1378010).

Removals from the web platform

HTML

• <link rel="preload"> (see Preloading content with rel=“preload”) has been disabled in Firefox 57 because of various web compatibility issues (e.g. Firefox bug 1405761). An improved version that works for non-cacheable resources is expected to land in Firefox 58.

APIs

• Mozilla’s proprietary Social API has been completely removed (Firefox bug 1388902).

SVG

No changes.

Changes for add-on and Mozilla developers

[!NOTE] Starting in Firefox 57, all support for XPCOM-based add-ons has been removed. All extensions must be converted into the new browser extensions (also known as WebExtensions) or they will not work.

WebExtensions

The following APIs have been added or extended:

• bookmarks

  • support for separators through bookmarks.BookmarkTreeNodeType

• browser_action

  • theme_icons property for light/dark theme icons

• browserAction

  • browserAction.openPopup()

• browserSettings

  • allowPopupsForUserEvents
  • homepageOverride
  • imageAnimationBehavior
  • newTabPageOverride

• browsingData

  • browsingData.removeLocalStorage()

• clipboard

  • setImageData()

• contextualIdentities

  • onCreated
  • onRemoved
  • onUpdated
  • colorCode and iconUrl in contextualIdentities.ContextualIdentity

• devtools.panels

  • devtools.panels.ElementsPanel.createSidebarPane()

• downloads

  • incognito option in downloads.download()
  • estimatedEndTime property in downloads.DownloadItem

• find

  • find()
  • highlightResults()
  • removeHighlighting()

• pageAction.openPopup()

• privacy

  • websites.trackingProtectionMode

• proxy

  • FindProxyForURL() can now return an object

• runtime

  • runtime.openOptionsPage() support on Android

• sessions

  • setTabValue()
  • getTabValue()
  • removeTabValue()
  • setWindowValue()
  • getWindowValue()
  • removeWindowValue()

• sidebarAction

  • sidebarAction.open()

• storage

  • storage.managed

• tabs

  • loadReplace option in tabs.update()
  • discarded property in tabs.Tab, tabs.onUpdated, and tabs.query()
  • tabs.create() can open “view-source:” URLs
  • openerTabId property in tabs.Tab, tabs.create(), tabs.query(), and tabs.update()

• theme

  • colors.toolbar
  • colors.toolbar_field
  • colors.toolbar_field_text
  • colors.toolbar_text

• theme

  • windowId option to theme.update()

• webRequest

  • filterResponseData()
  • proxyInfo property in webRequest events

• windows

  • allowScriptsToClose option in windows.create()

Older versions

{{Firefox_for_developers}}