diff --git a/docs/SeleniumLibrary-6.3.0.rst b/docs/SeleniumLibrary-6.3.0.rst new file mode 100644 index 000000000..cfc2a5ae5 --- /dev/null +++ b/docs/SeleniumLibrary-6.3.0.rst @@ -0,0 +1,136 @@ +===================== +SeleniumLibrary 6.3.0 +===================== + + +.. default-role:: code + + +SeleniumLibrary_ is a web testing library for `Robot Framework`_ that utilizes +the Selenium_ tool internally. SeleniumLibrary 6.3.0 is a new release with +enhancements including minimizing browesr window, waiting on expected conditions, +getting element attribute or properties and bug fixes. + + +If you have pip_ installed, just run + +:: + + pip install --upgrade robotframework-seleniumlibrary + +to install the latest available release or use + +:: + + pip install robotframework-seleniumlibrary==6.3.0 + +to install exactly this version. Alternatively you can download the source +distribution from PyPI_ and install it manually. + +SeleniumLibrary 6.3.0 was released on Friday April 19, 2024. SeleniumLibrary supports +Python 3.8 through 3.11, Selenium 4.14.0 through 4.19.0 and +Robot Framework 5.0.1, 6.1.1 and 7.0. + +.. _Robot Framework: http://robotframework.org +.. _SeleniumLibrary: https://github.com/robotframework/SeleniumLibrary +.. _Selenium: http://seleniumhq.org +.. _pip: http://pip-installer.org +.. _PyPI: https://pypi.python.org/pypi/robotframework-seleniumlibrary +.. _issue tracker: https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av6.3.0 + + +.. contents:: + :depth: 2 + :local: + +Most important enhancements +=========================== + +- Added ``Minimize Browser Window`` keyword (`#1741`_) + New keyword which minimizes the current browser window. + +- Add keywords to fetch differentiated element Attribute or Property (`#1822`_) + The older ``Get Element Attribute`` keyword uses the Selenium getAttribute() method which, + as `this SauceLabs article `_ describes + "did not actually retrieve the Attribute value." Instead it "figured out what the user + was most likely interested in between the Attribute value and the Property values and + returned it." This would mean sometimes it might return an unexpected result. Selenium 4 + introduced newer methods which returns either the attribute or the property as specifically + asked for. + + It is recommend that one transition to these newer ``Get DOM Attribute`` and ``Get Property`` + keywords. + +- Incorporate the expected conditions of Selenium (`#1827`_) + A new keyword that allows for one to wait on an expected condition. + +- Remove deprecation of Press Key keyword (`#1892`_) + The Press Keys keyword was introduced to replace Press Key. Press Key in turn was deprecated + but I (Ed Manlove) failed to remove. Its been noted that both keywords use different underlying + methods for sending or pressing keys and either one will work in differing situations. So + instead of removing Press Key, it has been reinstated as a library keyword. + +Acknowledgements +================ + +- `Luciano Martorella `_ contributing the new + minimize keyword (`#1741`_) +- `Yuri Verweij `_ and `Lisa Crispin `_ + for reviewing changes and additions to Attribute or Property keywords (`#1822`_) +- `Noam Manos `_ for reporting the issues where + the Open Browser 'Options' object has no attribute '' (`#1877`_) +- Yuri for helping update the contribution guide (`#1881`_) +- All those who have commented on the deprecation of Press Key keyword (`#1892`_) +- Yuri and Lisa for assisting with the addition of Wait For Expected Condition keyword + and for the Robot Framework Foundation for the ecosystem support (`#1827`_) + +and **Yuri Verweij, Lisa Crispin, and Tatu Aalto** for their continued support of the library development. + +Full list of fixes and enhancements +=================================== + +.. list-table:: + :header-rows: 1 + + * - ID + - Type + - Priority + - Summary + * - `#1741`_ + - enhancement + - high + - Added minimize keyword + * - `#1822`_ + - enhancement + - high + - Add keywords to fetch differentiated element Attribute or Property + * - `#1827`_ + - enhancement + - high + - Incorporate the expected conditions of Selenium + * - `#1892`_ + - --- + - high + - Remove deprecation of Press Key keyword + * - `#1877`_ + - enhancement + - medium + - Open Browser 'Options' object has no attribute '' + * - `#1881`_ + - --- + - medium + - Update contribution guide + * - `#1841`_ + - --- + - --- + - Update maintainers and email within setup.py + +Altogether 7 issues. View on the `issue tracker `__. + +.. _#1741: https://github.com/robotframework/SeleniumLibrary/issues/1741 +.. _#1822: https://github.com/robotframework/SeleniumLibrary/issues/1822 +.. _#1827: https://github.com/robotframework/SeleniumLibrary/issues/1827 +.. _#1892: https://github.com/robotframework/SeleniumLibrary/issues/1892 +.. _#1877: https://github.com/robotframework/SeleniumLibrary/issues/1877 +.. _#1881: https://github.com/robotframework/SeleniumLibrary/issues/1881 +.. _#1841: https://github.com/robotframework/SeleniumLibrary/issues/1841