devtools-unlock

Firefox add-on (MV3)

English · 中文

DevTools Unlock is a Chrome Web Store extension that also ships a Firefox 128+ Manifest V3 build. The injection model is the same as Chrome: per-host whitelist, scripting.registerContentScripts with world: "MAIN" and runAt: "document_start".

Official references:

Manifest V3 updates in Firefox 128 — MAIN world for content scripts and scripting.executeScript
scripting.registerContentScripts()
scripting.executeScript()

Requirements

Item	Value
Firefox	128 or newer (`strict_min_version`)
Gecko ID	`devtools-unlock@webliang` (stable; required for AMO / persistent installs)
Permissions	`storage`, `scripting`, `tabs`, host `<all_urls>`

<all_urls> is required so enabling a site can inject into cross-origin player iframes whose hosts are not known at install time. Optional origin permissions cannot cover those frames before they exist. Same justification as the Chrome Web Store listing.

Build and load (temporary)

pnpm install
pnpm build:firefox (or pnpm dev:firefox for watch)
Open about:debugging#/runtime/this-firefox
Load Temporary Add-on…
Select dist/firefox/manifest.json

Temporary add-ons disappear when Firefox quits. Persistent install is AMO or a signed zip with the Gecko ID above.

What the Firefox build changes

utils/manifest-parser (when __FIREFOX__=true):

background.service_worker → background.scripts + type: "module"
Adds browser_specific_settings.gecko (id, min version, data_collection_permissions: none)
Adds content_security_policy.extension_pages
Does not emit options_ui (this product has no options page)
Drops minimum_chrome_version

Runtime:

webextension-polyfill in the background
injectImmediately omitted on Firefox executeScript (MAIN-world early inject still uses registerContentScripts at document_start)
unlock.js / embedWatch.js remain classic IIFE (no import())

AMO zip + source

pnpm build:firefox:zip       # add-on → releases/*.firefox.zip
pnpm pack:firefox:sources    # source (no node_modules) → releases/*.firefox-sources.zip

The add-on zip is the contents of dist/firefox/ (not the git repo). AMO also requires the source archive because the add-on is a Vite/esbuild production bundle. Rebuild steps: SOURCE.md. How to pack: SOURCE.md.

Listing draft: LISTING.en.md. This repo does not auto-submit to AMO.

Lint

pnpm build:firefox
pnpm lint:firefox