Skip to content

Commit 74a1b50

Browse files
aaltataaltat
committed
Release notes for 3.2.0
1 parent 6fa57fa commit 74a1b50

1 file changed

Lines changed: 203 additions & 0 deletions

File tree

‎docs/SeleniumLibrary-3.2.0.rst‎

Lines changed: 203 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,203 @@
1+
=====================
2+
SeleniumLibrary 3.2.0
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 3.2.0 is a new release with
11+
enhancements and bug fixes. Example JavaScript keywords now supports arguments
12+
and Open Browser keyword provides support for headless Chrome and Firefox with
13+
Selenium Grid.
14+
15+
All issues targeted for SeleniumLibrary v3.2.0 can be found
16+
from the `issue tracker`_.
17+
18+
If you have pip_ installed, just run
19+
20+
::
21+
22+
pip install --upgrade robotframework-seleniumlibrary
23+
24+
to install the latest available release or use
25+
26+
::
27+
28+
pip install robotframework-seleniumlibrary==3.2.0
29+
30+
to install exactly this version. Alternatively you can download the source
31+
distribution from PyPI_ and install it manually.
32+
33+
SeleniumLibrary 3.2.0 was released on Friday September 21, 2018.
34+
35+
.. _Robot Framework: http://robotframework.org
36+
.. _SeleniumLibrary: https://github.com/robotframework/SeleniumLibrary
37+
.. _Selenium: http://seleniumhq.org
38+
.. _pip: http://pip-installer.org
39+
.. _PyPI: https://pypi.python.org/pypi/robotframework-seleniumlibrary
40+
.. _issue tracker: https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av3.2.0
41+
42+
43+
.. contents::
44+
:depth: 2
45+
:local:
46+
47+
Most important enhancements
48+
===========================
49+
50+
ElementFinder can't raise correct exception if locator contains characters like ö ä å (`#1084`_)
51+
-------------------------------------------------------------------------------------------------
52+
If element was not found and locator example contained ö character, then incorrect exception was
53+
raised by the library. This bug is now fixed and correct exception is not raised.
54+
55+
Headless Firefox and Chrome not working over selenium grid (`#1098`_)
56+
---------------------------------------------------------------------
57+
The Open Browser keyword supports headless Chrome and Firefox also when Selenium Grid is used.
58+
59+
Backwards incompatible changes
60+
==============================
61+
62+
Remove Python 3.3 support from SeleniumLibrary (`#1141`_)
63+
---------------------------------------------------------
64+
Robot Framework 3.1 will drop support for Python 3.3 and therefore the SeleniumLibrary 3.2 also
65+
drops support for Python 3.3. SeleniumLibrary supports Python 2.7 and 3.4 or newer.
66+
67+
Drop support for Selenium 2 and increase the required Selenium 3.4 version. (`#1142`_)
68+
--------------------------------------------------------------------------------------
69+
Support for Selenium 2 was dropped and minimum required Selenium version was raised to 3.4.0.
70+
71+
Passing attribute name as part of the locator is deprecated since SeleniumLibrary 3.0. Remove the support. (`#1185`_)
72+
---------------------------------------------------------------------------------------------------------------------
73+
Removed support passing attribute name as part of the locator. This is not anymore supported
74+
::
75+
76+
| ${id}= | Get Element Attribute | css:h1@id |
77+
78+
Instead this is only supported
79+
::
80+
81+
| ${id}= | Get Element Attribute | css:h1 | id |
82+
83+
Remove deprecated support for Set Screenshot Directory persist argument (`#1186`_)
84+
----------------------------------------------------------------------------------
85+
Deprecated persist argument was removed from Screenshot Directory keyword.
86+
87+
Remove deprecated aliases support from Select Window keyword (`#1187`_)
88+
-----------------------------------------------------------------------
89+
Deprecated aliases "None", "null" and the empty string for selecting the main window
90+
and alias "self" for selecting the current window where removed.
91+
92+
Deprecated features
93+
===================
94+
All silently deprecated keyword in 3.0 should be deprecated with warning. (`#963`_, rc 1)
95+
-----------------------------------------------------------------------------------------
96+
During the 3.0 several keywords where silently deprecated. In this release, using those
97+
keywords will display an warning. The next release will remote the deprecated keywords.
98+
99+
Acknowledgements
100+
================
101+
Many thanks for Tania Bhullar providing PR for adding message argument to Location Should Be keyword (`#1090`_).
102+
Many thanks for Dmitriy Robota for providing PR to Add scroll Element into view Keyword (`#763`_). Many
103+
thanks to DanielPBak fixing documentation bug for custom locator (`#1177`_). And last but not for least,
104+
many thanks to Marcin Koperski for providing PR to expose Selenium session id as a keyword. (`#1136`_).
105+
106+
Full list of fixes and enhancements
107+
===================================
108+
109+
.. list-table::
110+
:header-rows: 1
111+
112+
* - ID
113+
- Type
114+
- Priority
115+
- Summary
116+
* - `#963`_
117+
- enhancement
118+
- critical
119+
- All silently deprecated keyword in 3.0 should be deprecated with warning.
120+
* - `#1084`_
121+
- bug
122+
- high
123+
- ElementFinder can't raise correct exception if locator contains characters like ö ä å
124+
* - `#1098`_
125+
- enhancement
126+
- high
127+
- Headless Firefox and Chrome not working over selenium grid
128+
* - `#1141`_
129+
- enhancement
130+
- high
131+
- Remove Python 3.3 support from SeleniumLibrary
132+
* - `#1142`_
133+
- enhancement
134+
- high
135+
- Drop support for Selenium 2 and increase the required Selenium 3.4 version.
136+
* - `#1183`_
137+
- bug
138+
- medium
139+
- Update documentation: SeleniumLibrary is not thread safe
140+
* - `#1073`_
141+
- enhancement
142+
- medium
143+
- Create `Element Attribute Should Be locator attribute value`
144+
* - `#1090`_
145+
- enhancement
146+
- medium
147+
- Add message to Location Should Be keyword
148+
* - `#1185`_
149+
- enhancement
150+
- medium
151+
- Passing attribute name as part of the locator is deprecated since SeleniumLibrary 3.0. Remove the support.
152+
* - `#1186`_
153+
- enhancement
154+
- medium
155+
- Remove deprecated support for Set Screenshot Directory persist argument
156+
* - `#1187`_
157+
- enhancement
158+
- medium
159+
- Remove deprecated aliases support from Select Window keyword
160+
* - `#323`_
161+
- enhancement
162+
- medium
163+
- Allow arguments to be passed into JavaScript scripts
164+
* - `#757`_
165+
- enhancement
166+
- medium
167+
- Keyword to wait that windows is open
168+
* - `#763`_
169+
- enhancement
170+
- medium
171+
- Add scroll Element into view Keyword from ExtendedSelenium2Library
172+
* - `#905`_
173+
- enhancement
174+
- medium
175+
- Support holding shift and control when using `Click Element`
176+
* - `#1177`_
177+
- bug
178+
- low
179+
- Fix documentation bug for custom locator
180+
* - `#1136`_
181+
- enhancement
182+
- low
183+
- Expose Selenium session id as a keyword.
184+
185+
Altogether 17 issues. View on the `issue tracker <https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av3.2.0>`__.
186+
187+
.. _#963: https://github.com/robotframework/SeleniumLibrary/issues/963
188+
.. _#1084: https://github.com/robotframework/SeleniumLibrary/issues/1084
189+
.. _#1098: https://github.com/robotframework/SeleniumLibrary/issues/1098
190+
.. _#1141: https://github.com/robotframework/SeleniumLibrary/issues/1141
191+
.. _#1142: https://github.com/robotframework/SeleniumLibrary/issues/1142
192+
.. _#1183: https://github.com/robotframework/SeleniumLibrary/issues/1183
193+
.. _#1073: https://github.com/robotframework/SeleniumLibrary/issues/1073
194+
.. _#1090: https://github.com/robotframework/SeleniumLibrary/issues/1090
195+
.. _#1185: https://github.com/robotframework/SeleniumLibrary/issues/1185
196+
.. _#1186: https://github.com/robotframework/SeleniumLibrary/issues/1186
197+
.. _#1187: https://github.com/robotframework/SeleniumLibrary/issues/1187
198+
.. _#323: https://github.com/robotframework/SeleniumLibrary/issues/323
199+
.. _#757: https://github.com/robotframework/SeleniumLibrary/issues/757
200+
.. _#763: https://github.com/robotframework/SeleniumLibrary/issues/763
201+
.. _#905: https://github.com/robotframework/SeleniumLibrary/issues/905
202+
.. _#1177: https://github.com/robotframework/SeleniumLibrary/issues/1177
203+
.. _#1136: https://github.com/robotframework/SeleniumLibrary/issues/1136

0 commit comments

Comments
 (0)