Definition of session's "secure TLS state" flag is wordy, probably backwards
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 718
- Forks
- 228
- PR merge metrics
- No merged PRs in 30d
Description
In chapter 8. Sessions:
A session has an associated secure TLS state that indicates whether untrusted or self-signed TLS certificates should be trusted for the duration of the WebDriver session. If it is unset, this indicates that certificate- or TLS errors that occur upon navigation should be suppressed. The state can be unset by providing an "acceptInsecureCerts" capability with the value true. Unless stated otherwise, it is set.
I am so confused. If the value is unset, it says to suppress TLS errors. if passed {"acceptInsecureCerts": true} capability, unset the state (= don't suppress errors?). And by default, it is "set".
This would be much more readable by having "secure TLS" flag, and have the default be True. If passes {"acceptInsecureCerts": true}, then set "secure TLS" flag to false, meaning TLS errors are ignored and navigations are inherently less secure.
The notion of set versus unset seems more confusing than it's worth here. Especially because "setting" the flag via capability makes it "unset", and it's "set" by default. This seems backwards, at least at the spec level. I believe it will behave as intended as written, but it's needlessly confusing.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Chapter 8 Sessions definition linked in the issue and trace how the secure TLS state and acceptInsecureCerts capability are described. Done means the specification clearly explains the default state, the capability’s effect, and whether TLS errors are suppressed without relying on confusing set/unset wording.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100