This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 23020 - The use of "window" to mean "top level browsing context" is confusing.
Summary: The use of "window" to mean "top level browsing context" is confusing.
Status: RESOLVED FIXED
Alias: None
Product: Browser Test/Tools WG
Classification: Unclassified
Component: WebDriver (show other bugs)
Version: unspecified
Hardware: PC Linux
: P2 normal
Target Milestone: ---
Assignee: David Burns :automatedtester
QA Contact: Browser Testing and Tools WG
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: 20860
  Show dependency treegraph
 
Reported: 2013-08-20 15:18 UTC by James Graham
Modified: 2014-09-10 22:39 UTC (History)
2 users (show)

See Also:


Attachments

Description James Graham 2013-08-20 15:18:15 UTC
It seems that people (i.e. implementors) find the use of "window" to mean "top level browsing context" confusing. I think this is because there are already two alternate meanings of the term: "window" the name of the javascript global object, of which there is one per browsing context (top-level or not) and "window" the operating system feature, which may be associated with zero or more top level browsing contexts. In particular an easy mistake to make is to assume that getWindowHandles and similar methods should return one entry per OS window, rather than one per tab.

Given this confusion, I think it would be better to either write out "top level browsing context" explicitly, or invent some new term to mean that. This is just for the text, I presume it isn't reasonable to change the API for compatibility reasons.
Comment 1 David Burns :automatedtester 2014-09-10 22:39:11 UTC
https://dvcs.w3.org/hg/webdriver/rev/3057a35cec0c