1886602 - geckodriver - profiles - documentation needs updating

Status: NEW

(Testing :: geckodriver, defect, P3)

Description

[namelocmas]

User Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Safari/605.1.15

Steps to reproduce:

Documentation is out of date for the geckodriver profiles page:

https://firefox-source-docs.mozilla.org/testing/geckodriver/Profiles.html

Profiles heading

Note that geckodriver has a known bug concerning --profile that prevents the randomised Marionette port from being passed to geckodriver. To circumvent this issue, make sure you specify the port manually using --marionette-port <port>.

The linked bug is noted as fixed on GitHub:
https://github.com/mozilla/geckodriver/issues/1058#issuecomment-1057412616

Automation preferences heading

The marionette.js file listed in #2 no longer exists in the repository.

It appears this is now:

https://searchfox.org/mozilla-central/source/remote/shared/RecommendedPreferences.sys.mjs

Actual results:

N/A

Expected results:

N/A

Comment 1

[BugBot [:suhaib / :marco]]

The severity field is not set for this bug.
:Sylvestre, could you have a look please?

For more information, please visit BugBot documentation.

Comment 2

[Henrik Skupin [:whimboo][⌚️UTC+2]]

(In reply to namelocmas from comment #0)

Note that geckodriver has a known bug concerning --profile that prevents the randomised Marionette port from being passed to geckodriver. To circumvent this issue, make sure you specify the port manually using --marionette-port <port>.

The linked bug is noted as fixed on GitHub:
https://github.com/mozilla/geckodriver/issues/1058#issuecomment-1057412616

Would you mind explaining what you think is fixed? The problem on the referenced issue is/was with the --P argument but not --profile as referenced above.

The marionette.js file listed in #2 no longer exists in the repository.

It appears this is now:

https://searchfox.org/mozilla-central/source/remote/shared/RecommendedPreferences.sys.mjs

Thanks for the pointer. We indeed missed to update the reference when we re-organized the while structure of the code. We should indeed fix that.

The file, which needs an update, can be found at:
https://searchfox.org/mozilla-central/source/testing/geckodriver/doc/Profiles.md

Comment 3

[BugBot [:suhaib / :marco]]

Clear a needinfo that is pending on an inactive user.

Inactive users most likely will not respond; if the missing information is essential and cannot be collected another way, the bug maybe should be closed as INCOMPLETE.

For more information, please visit BugBot documentation.