docs(webextensions): document cross-browser MV3 background fallback#44108
Open
danyalahmed1995 wants to merge 7 commits into
Open
docs(webextensions): document cross-browser MV3 background fallback#44108danyalahmed1995 wants to merge 7 commits into
danyalahmed1995 wants to merge 7 commits into
Conversation
github-actions
Bot
added
Content:WebExt
Rob--W
requested changes
May 13, 2026
Contributor
|
Preview URLs (1 page) (comment last updated: 2026-05-25 17:49:53) |
rebloor
requested changes
May 13, 2026
…ound/index.md Co-authored-by: rebloor <git@sherpa.co.nz>
…ound/index.md Co-authored-by: rebloor <git@sherpa.co.nz>
Rob--W
reviewed
May 13, 2026
Rob--W
requested changes
May 23, 2026
Member
Rob--W
left a comment
Rob--W
left a comment
There was a problem hiding this comment.
This PR is changing the example for the worse. The original example was designed to be minimal yet easily observable. The update changes metadata unnecessarily and changes the obvious behavior to a log, which is not as easily discoverable.
Contributor
Author
|
@Rob--W Yeah my bad you are right.I restored the original observable example behavior and metadata, and kept the update limited to the wording changes from the earlier review. |
rebloor
approved these changes
May 25, 2026
Contributor
rebloor
left a comment
rebloor
left a comment
There was a problem hiding this comment.
Thanks for making the text changes
Rob--W
requested changes
May 25, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a focused section to the WebExtensions
backgroundmanifest documentation explaining how a Manifest V3 extension can specify bothbackground.scriptsandbackground.service_workerfor cross-browser background behavior.The update also clarifies that
background.preferred_environmentis not required for the basic fallback behavior, and should only be used when an extension specifically wants to prefer a service worker where available.Fixes #44100.
Validation
npx --yes prettier@3.8.3 --check "files/en-us/mozilla/add-ons/webextensions/manifest.json/background/index.md"npx --yes --package markdownlint-cli2@0.22.1 --package markdownlint-rule-search-replace@1.2.0 markdownlint-cli2 "files/en-us/mozilla/add-ons/webextensions/manifest.json/background/index.md"git diff --check