w3c / w3c/webdriver

Switch To Frame: clarify language when selecting frame by index

Open
#1,205 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
HTML
Stars
718
Forks
228
PR merge metrics
No merged PRs in 30d

Description

The section switch to frame in the specs is a little unclear in regards of what "ID" is supposed to be.
According to the specs:

If id is not null, a Number object, or an Object that represents a web element, return error with error code no such frame.

While id is null and id represents a web element are clear, id is a Number object leaves me with the question: "which number"? The link to supported properties index points to the IDL specs' cover of supported property index.

So... where do I get this number from, exactly, if I wanted to use to switch frame?

Please remember that I am not talking about programming languages API -- I am talking about the usage of the API without support library. I am specifying this because the IDL link seems to be all about Java, whereas my question is on the use of the Webdriver endpoints.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Switch To Frame section in the WebDriver specification and follow its supported property index link to the Web IDL definition. Clarify what the numeric frame identifier represents and how a direct WebDriver endpoint caller obtains it; the section should answer the issue's question without relying on a programming-language API.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.