Skip to content

Commit 67f9cf9

Browse files
aaltataaltat
committed
Release notes for 4.2.0rc1
1 parent 3e5a909 commit 67f9cf9

File tree

1 file changed

+198
-0
lines changed

1 file changed

+198
-0
lines changed

‎docs/SeleniumLibrary-4.2.0rc1.rst‎

Lines changed: 198 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,198 @@
1+
========================
2+
SeleniumLibrary 4.2.0rc1
3+
========================
4+
5+
6+
.. default-role:: code
7+
8+
9+
SeleniumLibrary_ is a web testing library for `Robot Framework`_ that utilizes
10+
the Selenium_ tool internally. SeleniumLibrary 4.2.0rc1 is a new pre-release with
11+
embedding screenshot to log.html and possibility add executable_path in the Open
12+
Browser keyword. Also the Open Browser options argument supports defining complex
13+
Python data object, like example dictionary. The most important fixes are in the
14+
Press Keys keyword and when EventFiringWebDriver is used with WebElements as
15+
locators.
16+
17+
All issues targeted for SeleniumLibrary v4.2.0 can be found
18+
from the `issue tracker`_.
19+
20+
If you have pip_ installed, just run
21+
22+
::
23+
24+
pip install --pre --upgrade robotframework-seleniumlibrary
25+
26+
to install the latest available release or use
27+
28+
::
29+
30+
pip install robotframework-seleniumlibrary==4.2.0rc1
31+
32+
to install exactly this version. Alternatively you can download the source
33+
distribution from PyPI_ and install it manually.
34+
35+
SeleniumLibrary 4.2.0rc1 was released on Thursday January 25, 2020. SeleniumLibrary supports
36+
Python 2.7 and 3.5+, Selenium 3.141.0 and Robot Framework 3.1.2. This is last release which
37+
contains new development for Python 2.7 and users should migrate to Python 3.
38+
39+
.. _Robot Framework: http://robotframework.org
40+
.. _SeleniumLibrary: https://github.com/robotframework/SeleniumLibrary
41+
.. _Selenium: http://seleniumhq.org
42+
.. _pip: http://pip-installer.org
43+
.. _PyPI: https://pypi.python.org/pypi/robotframework-seleniumlibrary
44+
.. _issue tracker: https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av4.2.0
45+
46+
47+
.. contents::
48+
:depth: 2
49+
:local:
50+
51+
Most important enhancements
52+
===========================
53+
54+
Fix Press Keys to support multiple key pressing (`#1489`_, rc 1)
55+
-----------------------------------------------------------------
56+
Fixes Press Keys keyword to send multiple keys with in single keyword. When multiple keys where send
57+
keyword did clear the previous keys from a input field. Now this issue is fixed.
58+
59+
When EventFiringWebDriver is enabled, elements from `Get WebElement(s)` keywords are not recoginized as instance of WebElement (`#1538`_, rc 1)
60+
------------------------------------------------------------------------------------------------------------------------------------------------
61+
When EventFiringWebDriver is enabled, WebElements could not be used as locators in keywords. This raised and exception.
62+
This problem is not fixed and using EventFiringWebDriver and WebElements as locators is possible.
63+
64+
Input Password keyword should also prevent password being visible from the Selenium logging (`#1454`_, rc 1)
65+
------------------------------------------------------------------------------------------------------------
66+
Input Password keyword suppress the Selenium logging and the password is not anymore visible in the log.html
67+
file. Please note that password is visible if Robot Framework logging reveals the variable content.
68+
69+
Open Browser keyword options argument does not support parsing complex structures. (`#1530`_, rc 1)
70+
---------------------------------------------------------------------------------------------------
71+
The options argument did not support dictionary objects or other complex Python object in the Open Browser
72+
keyword. Example dictionaries where used to enable mobile emulation in the Chrome browser. After this
73+
enhancement complex object are supported in the options argument.
74+
75+
Backwards incompatible changes
76+
==============================
77+
78+
Raise minimum required Selenium version to 3.14 to ease support for Selenium 4 (`#1493`_, rc 1)
79+
-----------------------------------------------------------------------------------------------
80+
The minimum required Selenium version to 3.14 to ease support Selenium 4 in the future.
81+
82+
83+
Drop Robot Framework 3.0.x support (`#1513`_, rc 1)
84+
---------------------------------------------------
85+
SeleniumLibrary supports Robot Framework 3.1.2 and older versions are not anymore supported.
86+
87+
Acknowledgements
88+
================
89+
90+
When EventFiringWebDriver is enabled, elements from `Get WebElement(s)` keywords are not recoginized as instance of WebElement (`#1538`_, rc 1)
91+
-----------------------------------------------------------------------------------------------------------------------------------------------
92+
Many thanks for rasjani providing PR to fix EventFiringWebDriver and using WebElements are locators.
93+
94+
If JavaScript code is long then Execute JavaScrpt will fail in windows (`#1524`_, rc 1)
95+
---------------------------------------------------------------------------------------
96+
Many thanks to lmartorella improving of the Execute JavaScript keyword to work better
97+
in Windows OS.
98+
99+
'Handle Alert' keyword treats all exceptions as timeout (`#1500`_, rc 1)
100+
------------------------------------------------------------------------
101+
Many thanks to Zeckie improving error message in the Handle Alert keyword.
102+
103+
Close Browser does not delete alias (`#1416`_, rc 1)
104+
----------------------------------------------------
105+
Many thanks to anton264 improving closing browser functionality so that browser alias is deleted.
106+
107+
Full list of fixes and enhancements
108+
===================================
109+
110+
.. list-table::
111+
:header-rows: 1
112+
113+
* - ID
114+
- Type
115+
- Priority
116+
- Summary
117+
- Added
118+
* - `#1493`_
119+
- enhancement
120+
- critical
121+
- Raise minimum required Selenium version to 3.14 to ease support for Selenium 4
122+
- rc 1
123+
* - `#1489`_
124+
- bug
125+
- high
126+
- Fix Press Keys to support multiple key pressing
127+
- rc 1
128+
* - `#1538`_
129+
- bug
130+
- high
131+
- When EventFiringWebDriver is enabled, elements from `Get WebElement(s)` keywords are not recoginized as instance of WebElement
132+
- rc 1
133+
* - `#1454`_
134+
- enhancement
135+
- high
136+
- Input Password keyword should also prevent password being visible from the Selenium logging
137+
- rc 1
138+
* - `#1513`_
139+
- enhancement
140+
- high
141+
- Drop Robot Framework 3.0.x support
142+
- rc 1
143+
* - `#1530`_
144+
- enhancement
145+
- high
146+
- Open Browser keyword options argument does not support parsing complex structures.
147+
- rc 1
148+
* - `#1496`_
149+
- bug
150+
- medium
151+
- Fix Create WebDriver examples
152+
- rc 1
153+
* - `#1524`_
154+
- bug
155+
- medium
156+
- If JavaScript code is long then Execute JavaScrpt will fail in windows
157+
- rc 1
158+
* - `#1473`_
159+
- enhancement
160+
- medium
161+
- Open Browser keyword and Selenium options with Windows path needs double escaping
162+
- rc 1
163+
* - `#1483`_
164+
- enhancement
165+
- medium
166+
- add support to embed screenshots in reports
167+
- rc 1
168+
* - `#1500`_
169+
- enhancement
170+
- medium
171+
- 'Handle Alert' keyword treats all exceptions as timeout
172+
- rc 1
173+
* - `#1536`_
174+
- enhancement
175+
- medium
176+
- Add possibility to configure executable_path in the Open Browser keywords
177+
- rc 1
178+
* - `#1416`_
179+
- bug
180+
- low
181+
- Close Browser does not delete alias
182+
- rc 1
183+
184+
Altogether 13 issues. View on the `issue tracker <https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av4.2.0>`__.
185+
186+
.. _#1493: https://github.com/robotframework/SeleniumLibrary/issues/1493
187+
.. _#1489: https://github.com/robotframework/SeleniumLibrary/issues/1489
188+
.. _#1538: https://github.com/robotframework/SeleniumLibrary/issues/1538
189+
.. _#1454: https://github.com/robotframework/SeleniumLibrary/issues/1454
190+
.. _#1513: https://github.com/robotframework/SeleniumLibrary/issues/1513
191+
.. _#1530: https://github.com/robotframework/SeleniumLibrary/issues/1530
192+
.. _#1496: https://github.com/robotframework/SeleniumLibrary/issues/1496
193+
.. _#1524: https://github.com/robotframework/SeleniumLibrary/issues/1524
194+
.. _#1473: https://github.com/robotframework/SeleniumLibrary/issues/1473
195+
.. _#1483: https://github.com/robotframework/SeleniumLibrary/issues/1483
196+
.. _#1500: https://github.com/robotframework/SeleniumLibrary/issues/1500
197+
.. _#1536: https://github.com/robotframework/SeleniumLibrary/issues/1536
198+
.. _#1416: https://github.com/robotframework/SeleniumLibrary/issues/1416

0 commit comments

Comments
 (0)