You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
How to locate windows is pretty complicated and not very well documented. There are also lot of undocumented and untested features. This issue covers cleaning up the functionality and, very importantly, documenting it adequately.
As part of the cleanup, undocumented features that are not considered useful are deprecated or removed. Such changes are obviously backwards incompatible, but because these are undocumented features, it's very unlikely that they are used widely. This is the functionality that is going to change:
Using Python None or string null or empty string as a locator to select the main window is deprecated. Use documented main (default) instead.
Using popup to select the latest new window is deprecated. Use documented new instead.
Using self to select the current window is deprecated. Use earlier undocumented but much more explicit current instead.
Locating windows by name, title or URL is not case-insensitive anymore.
Specifying explicit locator strategy is not case-insensitive anymore.
There area also some enhancements:
New keyword Get Window Handles is added to replace List Windows later. The old keyword is "silently deprecated" at this point.
How to locate windows is pretty complicated and not very well documented. There are also lot of undocumented and untested features. This issue covers cleaning up the functionality and, very importantly, documenting it adequately.
As part of the cleanup, undocumented features that are not considered useful are deprecated or removed. Such changes are obviously backwards incompatible, but because these are undocumented features, it's very unlikely that they are used widely. This is the functionality that is going to change:
None
or stringnull
or empty string as a locator to select the main window is deprecated. Use documentedmain
(default) instead.popup
to select the latest new window is deprecated. Use documentednew
instead.self
to select the current window is deprecated. Use earlier undocumented but much more explicitcurrent
instead.There area also some enhancements:
Get Window Handles
is added to replaceList Windows
later. The old keyword is "silently deprecated" at this point.strategy:value
syntax in addition tostrategy=value
(see also Newstrategy:value
syntax to specify locator strategy in addition to currentstrategy=value
#908).The text was updated successfully, but these errors were encountered: