Definition of "collection" is nonsensical
Open
Nobody has claimed this yet.
Execute Async Script
Execute Script
- Dominant language
- HTML
- Stars
- 718
- Forks
- 228
- PR merge metrics
- No merged PRs in 30d
Description
https://w3c.github.io/webdriver/#dfn-collection
A collection is an Object that implements the Iterable interface, and whose:
- initial value of the toString own property is "Arguments"
- instance of Array
- instance of DOMTokenList
- ...
Problems:
- Expressions like "whose [...] instance of Array" are ungrammatical
- It's unclear whether all conditions of the list must hold, or a single one suffices
Argumentsobjects do not have atoStringown property. They inherit atoStringproperty but its value isn't a string, it's a function.
What this probably meant was Call(%Object.prototype.toString%, collection), but of course this would still consider({[Symbol.toStringTag]: "Arguments"})as an Arguments object even if that's not the case.
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 at the WebDriver specification's collection definition linked in the issue, then review the referenced definitions for Object, Iterable, initial value, own properties, Array, and DOMTokenList. Clarify the list's grammar and intended conditions, and verify the Arguments-object wording against the linked ECMAScript Call definition; done when the definition is precise and unambiguous.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100