Bug-1930334 to implement background.preferred_environment

[rebloor]

Description

Add release note and documentation for the introduction of preferred_environment to the background manifest key as implemented by Bug 1930334 Implement background.preferred_environment.

Related issues and pull requests

Corresponding changes to the browser compatibility data in TBC

[github-actions]

This pull request has merge conflicts that must be resolved before it can be merged.

[github-actions]

Preview URLs

• /en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/background
• /en-US/docs/Mozilla/Firefox/Releases/136

Flaws (2)

Note! 1 document with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Mozilla/Firefox/Releases/136
Title: Firefox 136 for developers
Flaw count: 2

• macros:
  • Macro produces link /en-US/docs/Mozilla/Add-ons/WebExtensions/API/contextMenus/update which is a redirect
  • Macro produces link /en-US/docs/Mozilla/Add-ons/WebExtensions/API/contextMenus/remove which is a redirect

External URLs (1)

URL: /en-US/docs/Mozilla/Firefox/Releases/136
Title: Firefox 136 for developers

• https://bugzil.la/1798655 (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-01-31 16:10:19)

[carlosjeurissen]

Thanks for updating the docs! Made a few changes to clarify this is an array, not a string value.

[carlosjeurissen]

Suggested change

	<p>A <code>String</code> value.</p>
	<p>An <code>Array</code> of <code>String<code>.</p>

[rebloor]

@carlosjeurissen so you could specify ["document", "service_worker"]? Or can you only specify one value in the array?

[carlosjeurissen]

@rebloor yes, multiple values can be specified. Any of the following are valid:
["document", "service_worker"]
["service_worker", "document"]
["service_worker"]
["document"]
And potentially more

The most sensible at this moment however are
["service_worker", "document"] and
["document", "service_worker"]

As you either prefer the "document" or "service_worker" environment.