Skip to content

Commit cbc6fad

Browse files
emanloveemanlove
committed
Release notes for 6.3.0
1 parent fa73b24 commit cbc6fad

File tree

1 file changed

+136
-0
lines changed

1 file changed

+136
-0
lines changed

‎docs/SeleniumLibrary-6.3.0.rst

Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
=====================
2+
SeleniumLibrary 6.3.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 6.3.0 is a new release with
11+
enhancements including minimizing browesr window, waiting on expected conditions,
12+
getting element attribute or properties and bug fixes.
13+
14+
15+
If you have pip_ installed, just run
16+
17+
::
18+
19+
pip install --upgrade robotframework-seleniumlibrary
20+
21+
to install the latest available release or use
22+
23+
::
24+
25+
pip install robotframework-seleniumlibrary==6.3.0
26+
27+
to install exactly this version. Alternatively you can download the source
28+
distribution from PyPI_ and install it manually.
29+
30+
SeleniumLibrary 6.3.0 was released on Friday April 19, 2024. SeleniumLibrary supports
31+
Python 3.8 through 3.11, Selenium 4.14.0 through 4.19.0 and
32+
Robot Framework 5.0.1, 6.1.1 and 7.0.
33+
34+
.. _Robot Framework: http://robotframework.org
35+
.. _SeleniumLibrary: https://github.com/robotframework/SeleniumLibrary
36+
.. _Selenium: http://seleniumhq.org
37+
.. _pip: http://pip-installer.org
38+
.. _PyPI: https://pypi.python.org/pypi/robotframework-seleniumlibrary
39+
.. _issue tracker: https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av6.3.0
40+
41+
42+
.. contents::
43+
:depth: 2
44+
:local:
45+
46+
Most important enhancements
47+
===========================
48+
49+
- Added ``Minimize Browser Window`` keyword (`#1741`_)
50+
New keyword which minimizes the current browser window.
51+
52+
- Add keywords to fetch differentiated element Attribute or Property (`#1822`_)
53+
The older ``Get Element Attribute`` keyword uses the Selenium getAttribute() method which,
54+
as `this SauceLabs article <https://saucelabs.com/resources/blog/selenium-4-new-element-attribute-and-property-methods>`_ describes
55+
"did not actually retrieve the Attribute value." Instead it "figured out what the user
56+
was most likely interested in between the Attribute value and the Property values and
57+
returned it." This would mean sometimes it might return an unexpected result. Selenium 4
58+
introduced newer methods which returns either the attribute or the property as specifically
59+
asked for.
60+
61+
It is recommend that one transition to these newer ``Get DOM Attribute`` and ``Get Property``
62+
keywords.
63+
64+
- Incorporate the expected conditions of Selenium (`#1827`_)
65+
A new keyword that allows for one to wait on an expected condition.
66+
67+
- Remove deprecation of Press Key keyword (`#1892`_)
68+
The Press Keys keyword was introduced to replace Press Key. Press Key in turn was deprecated
69+
but I (Ed Manlove) failed to remove. Its been noted that both keywords use different underlying
70+
methods for sending or pressing keys and either one will work in differing situations. So
71+
instead of removing Press Key, it has been reinstated as a library keyword.
72+
73+
Acknowledgements
74+
================
75+
76+
- `Luciano Martorella <https://github.com/lmartorella>`_ contributing the new
77+
minimize keyword (`#1741`_)
78+
- `Yuri Verweij <https://github.com/yuriverweij>`_ and `Lisa Crispin <https://lisacrispin.com/>`_
79+
for reviewing changes and additions to Attribute or Property keywords (`#1822`_)
80+
- `Noam Manos <https://github.com/manosnoam>`_ for reporting the issues where
81+
the Open Browser 'Options' object has no attribute '' (`#1877`_)
82+
- Yuri for helping update the contribution guide (`#1881`_)
83+
- All those who have commented on the deprecation of Press Key keyword (`#1892`_)
84+
- Yuri and Lisa for assisting with the addition of Wait For Expected Condition keyword
85+
and for the Robot Framework Foundation for the ecosystem support (`#1827`_)
86+
87+
and **Yuri Verweij, Lisa Crispin, and Tatu Aalto** for their continued support of the library development.
88+
89+
Full list of fixes and enhancements
90+
===================================
91+
92+
.. list-table::
93+
:header-rows: 1
94+
95+
* - ID
96+
- Type
97+
- Priority
98+
- Summary
99+
* - `#1741`_
100+
- enhancement
101+
- high
102+
- Added minimize keyword
103+
* - `#1822`_
104+
- enhancement
105+
- high
106+
- Add keywords to fetch differentiated element Attribute or Property
107+
* - `#1827`_
108+
- enhancement
109+
- high
110+
- Incorporate the expected conditions of Selenium
111+
* - `#1892`_
112+
- ---
113+
- high
114+
- Remove deprecation of Press Key keyword
115+
* - `#1877`_
116+
- enhancement
117+
- medium
118+
- Open Browser 'Options' object has no attribute ''
119+
* - `#1881`_
120+
- ---
121+
- medium
122+
- Update contribution guide
123+
* - `#1841`_
124+
- ---
125+
- ---
126+
- Update maintainers and email within setup.py
127+
128+
Altogether 7 issues. View on the `issue tracker <https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av6.3.0>`__.
129+
130+
.. _#1741: https://github.com/robotframework/SeleniumLibrary/issues/1741
131+
.. _#1822: https://github.com/robotframework/SeleniumLibrary/issues/1822
132+
.. _#1827: https://github.com/robotframework/SeleniumLibrary/issues/1827
133+
.. _#1892: https://github.com/robotframework/SeleniumLibrary/issues/1892
134+
.. _#1877: https://github.com/robotframework/SeleniumLibrary/issues/1877
135+
.. _#1881: https://github.com/robotframework/SeleniumLibrary/issues/1881
136+
.. _#1841: https://github.com/robotframework/SeleniumLibrary/issues/1841

0 commit comments

Comments
 (0)