1943050 - Enable userScripts API by default

Status: RESOLVED FIXED

(WebExtensions :: General, task, P2)

Description

[Rob Wu [:robwu]]

The implementation of the userScripts API has been available behind a flag for a few releases now. The API is ready, and the most significant blocker (opt-in UX as described in bug 1917000) has been resolved, with the desktop implementation landed in 135 (bug 1931548), and passed QA.

This bug tracks enabling the feature by default on desktop.

Mobile may follow later, since the mobile UI is still in progress (bug 1931554 & bug 1931556).

Comment 1

[Rob Wu [:robwu]]

Attachment: Bug 1943050 - Enable userScripts API by default on desktop

Comment 2

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/66b863986ea3
Enable userScripts API by default on desktop r=willdurand,geckoview-reviewers,calu

Comment 3

[Rob Wu [:robwu]]

Documentation tasks:

Update old documentation to emphasize their irrelevance:

• user_scripts manifest key: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts
• Replace overview with pointers to new API: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/userScripts
• userScripts.register() (confusingly - same name as the new API). The old page may need to be relocated to a new place: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/userScripts/register
• https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/userScripts/Working_with_userScripts

New content:

• API definitions at https://searchfox.org/mozilla-central/source/toolkit/components/extensions/schemas/user_scripts.json
• Code sample with demo and documentation nearly ready to merge at https://github.com/mdn/webextensions-examples/pull/576
• browser-compat-data with Firefox and Chrome support data. Chrome docs: https://developer.chrome.com/docs/extensions/reference/api/userScripts
• Mention in Firefox 136 for devs: https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Releases/136
• "userScripts" is an example of an optional-only permission, in Firefox (not Chrome) - https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/optional_permissions#optional-only_permissions
• Descriptions and mock-ups of how the opt-in UI may look like: https://bugzilla.mozilla.org/show_bug.cgi?id=1917000
  • (strongly encourage loading the example from https://github.com/mdn/webextensions-examples/pull/576 to generate new screenshots of actual browser UI!)

Non-MDN content updates:

• Add userScripts and permission warning to https://extensionworkshop.com/documentation/develop/request-the-right-permissions/
• (I will handle this separately) add the new permission warning and description to user documentation at https://support.mozilla.org/en-US/kb/permission-request-messages-firefox-extensions

Comment 4

[Cristian Tuns]

https://hg.mozilla.org/mozilla-central/rev/66b863986ea3