Clarify devtools.panels.create() path resolution

[rebloor]

Summary

Adds browser variation clarifications originally proposed in mdn/content#20552

[bsmth]

I can take a look on Monday if that's okay? Set myself as a reviewer so I don't forget about it.

[rebloor]

Thanks @bsmth

[bsmth]

Noting that options is set to mirror for Fx android, https://github.com/mdn/browser-compat-data/blob/459da79f9ec222665fc90151e7f37fc7ae26e1d4/webextensions/api/devtools.json#L68C20-L68C35 while false for all other features - I'm guessing this should be false also?

[bsmth]

The suggestion in the related PR states this may also be relative to the extension directory and the extensions docs say a URL "relative to the extension directory"

[rebloor]

@bsmth within the context of a web extension they are the same thing e.g. "you can specify the path as an absolute URL, starting at the extension's root, like this: /path/to/stylesheet.css" e.g. the extension root is the starting point. Hence we have statements such as "When a content script makes an HTTP(S) request, you must provide absolute URLs." in the web extensions docs.

[rebloor]

@bsmth

Noting that options is set to mirror for Fx android, https://github.com/mdn/browser-compat-data/blob/459da79f9ec222665fc90151e7f37fc7ae26e1d4/webextensions/api/devtools.json#L68C20-L68C35 while false for all other features - I'm guessing this should be false also?

Probably "should be" (given that Firefox for Android will almost certainly never support devtools.) However, you can't make that change because the linter considers it to be an error:

 ✖ webextensions.api.devtools.inspectedWindow.eval.options - Error → Data for firefox_android can be automatically mirrored, use "firefox_android": "mirror" instead```
and If you attempt to commit the change the linter automatically "fixes" the issue prior to committing.

[bsmth]

If you attempt to commit the change the linter automatically "fixes" the issue prior to committing.

You're right, I guess we're forced to mirror unless there is support in Firefox and a need to disambiguate.

edit: this lives here btw: https://github.com/mdn/browser-compat-data/blob/main/test/linter/test-mirror.ts

[bsmth]

Looks good, thank you! Merging shortly 👍🏻