|
| 1 | +======================== |
| 2 | +SeleniumLibrary 3.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 3.2.0rc1 is a new pre-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 --pre --upgrade robotframework-seleniumlibrary |
| 23 | + |
| 24 | +to install the latest available release or use |
| 25 | + |
| 26 | +:: |
| 27 | + |
| 28 | + pip install robotframework-seleniumlibrary==3.2.0rc1 |
| 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.0rc1 was released on Sunday September 16, 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`_, rc 1) |
| 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`_, rc 1) |
| 56 | +--------------------------------------------------------------------------- |
| 57 | +The Open Browser keyword supports headless Chrome and Firefox also when Selenium Grid is used. |
| 58 | + |
| 59 | +- Remove Python 3.3 support from SeleniumLibrary (`#1141`_, rc 1) |
| 60 | +- Drop support for Selenium 2 and increase the required Selenium 3.4 version. (`#1142`_, rc 1) |
| 61 | + |
| 62 | +Backwards incompatible changes |
| 63 | +============================== |
| 64 | +Remove Python 3.3 support from SeleniumLibrary (`#1141`_, rc 1) |
| 65 | +--------------------------------------------------------------- |
| 66 | +Robot Framework 3.1 will drop support for Python 3.3 and therefore the SeleniumLibrary 3.2 also |
| 67 | +drops support for Python 3.3. SeleniumLibrary supports Python 2.7 and 3.4 or newer. |
| 68 | + |
| 69 | +Drop support for Selenium 2 and increase the required Selenium 3.4 version. (`#1142`_, rc 1) |
| 70 | +-------------------------------------------------------------------------------------------- |
| 71 | +Support for Selenium 2 was dropped and minimum required Selenium version was raised to 3.4.0. |
| 72 | + |
| 73 | +Passing attribute name as part of the locator is deprecated since SeleniumLibrary 3.0. Remove the support. (`#1185`_, rc 1) |
| 74 | +--------------------------------------------------------------------------------------------------------------------------- |
| 75 | +Removed support passing attribute name as part of the locator |
| 76 | + |
| 77 | +Remove deprecated support for Set Screenshot Directory persist argument (`#1186`_, rc 1) |
| 78 | +---------------------------------------------------------------------------------------- |
| 79 | +Deprecated persist argument was removed. |
| 80 | + |
| 81 | +Remove deprecated aliases support from Select Window keyword (`#1187`_, rc 1) |
| 82 | +----------------------------------------------------------------------------- |
| 83 | +Deprecated aliases None, null`` and the empty string for selecting the main window |
| 84 | +and alias self for selecting the current window where removed. |
| 85 | + |
| 86 | +Deprecated features |
| 87 | +=================== |
| 88 | +All silently deprecated keyword in 3.0 should be deprecated with warning. (`#963`_, rc 1) |
| 89 | +----------------------------------------------------------------------------------------- |
| 90 | +During the 3.0 several keywords where silently deprecated. In this release, using those |
| 91 | +keywords will display an warning. The next release will remote the deprecated keywords. |
| 92 | + |
| 93 | +Acknowledgements |
| 94 | +================ |
| 95 | +Many thanks for Tania Bhullar providing PR for adding message argument to Location Should Be keyword (`#1090`_, rc 1). |
| 96 | +Many thanks for Dmitriy Robota for providing PR to Add scroll Element into view Keyword (`#763`_, rc 1). Many |
| 97 | +thanks to DanielPBak fixing documentation bug for custom locator (`#1177`_, rc 1). And last but not for least, |
| 98 | +many thanks to Marcin Koperski for providing PR to expose Selenium session id as a keyword. (`#1136`_, rc 1). |
| 99 | + |
| 100 | +Full list of fixes and enhancements |
| 101 | +=================================== |
| 102 | + |
| 103 | +.. list-table:: |
| 104 | + :header-rows: 1 |
| 105 | + |
| 106 | + * - ID |
| 107 | + - Type |
| 108 | + - Priority |
| 109 | + - Summary |
| 110 | + - Added |
| 111 | + * - `#963`_ |
| 112 | + - enhancement |
| 113 | + - critical |
| 114 | + - All silently deprecated keyword in 3.0 should be deprecated with warning. |
| 115 | + - rc 1 |
| 116 | + * - `#1084`_ |
| 117 | + - bug |
| 118 | + - high |
| 119 | + - ElementFinder can't raise correct exception if locator contains characters like ö ä å |
| 120 | + - rc 1 |
| 121 | + * - `#1098`_ |
| 122 | + - enhancement |
| 123 | + - high |
| 124 | + - Headless Firefox and Chrome not working over selenium grid |
| 125 | + - rc 1 |
| 126 | + * - `#1141`_ |
| 127 | + - enhancement |
| 128 | + - high |
| 129 | + - Remove Python 3.3 support from SeleniumLibrary |
| 130 | + - rc 1 |
| 131 | + * - `#1142`_ |
| 132 | + - enhancement |
| 133 | + - high |
| 134 | + - Drop support for Selenium 2 and increase the required Selenium 3.4 version. |
| 135 | + - rc 1 |
| 136 | + * - `#1183`_ |
| 137 | + - bug |
| 138 | + - medium |
| 139 | + - Update documentation: SeleniumLibrary is not thread safe |
| 140 | + - rc 1 |
| 141 | + * - `#1073`_ |
| 142 | + - enhancement |
| 143 | + - medium |
| 144 | + - Create `Element Attribute Should Be locator attribute value` |
| 145 | + - rc 1 |
| 146 | + * - `#1090`_ |
| 147 | + - enhancement |
| 148 | + - medium |
| 149 | + - Add message to Location Should Be keyword |
| 150 | + - rc 1 |
| 151 | + * - `#1185`_ |
| 152 | + - enhancement |
| 153 | + - medium |
| 154 | + - Passing attribute name as part of the locator is deprecated since SeleniumLibrary 3.0. Remove the support. |
| 155 | + - rc 1 |
| 156 | + * - `#1186`_ |
| 157 | + - enhancement |
| 158 | + - medium |
| 159 | + - Remove deprecated support for Set Screenshot Directory persist argument |
| 160 | + - rc 1 |
| 161 | + * - `#1187`_ |
| 162 | + - enhancement |
| 163 | + - medium |
| 164 | + - Remove deprecated aliases support from Select Window keyword |
| 165 | + - rc 1 |
| 166 | + * - `#323`_ |
| 167 | + - enhancement |
| 168 | + - medium |
| 169 | + - Allow arguments to be passed into JavaScript scripts |
| 170 | + - rc 1 |
| 171 | + * - `#757`_ |
| 172 | + - enhancement |
| 173 | + - medium |
| 174 | + - Keyword to wait that windows is open |
| 175 | + - rc 1 |
| 176 | + * - `#763`_ |
| 177 | + - enhancement |
| 178 | + - medium |
| 179 | + - Add scroll Element into view Keyword from ExtendedSelenium2Library |
| 180 | + - rc 1 |
| 181 | + * - `#905`_ |
| 182 | + - enhancement |
| 183 | + - medium |
| 184 | + - Support holding shift and control when using `Click Element` |
| 185 | + - rc 1 |
| 186 | + * - `#1177`_ |
| 187 | + - bug |
| 188 | + - low |
| 189 | + - Fix documentation bug for custom locator |
| 190 | + - rc 1 |
| 191 | + * - `#1136`_ |
| 192 | + - enhancement |
| 193 | + - low |
| 194 | + - Expose Selenium session id as a keyword. |
| 195 | + - rc 1 |
| 196 | + |
| 197 | +Altogether 17 issues. View on the `issue tracker <https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av3.2.0>`__. |
| 198 | + |
| 199 | +.. _#963: https://github.com/robotframework/SeleniumLibrary/issues/963 |
| 200 | +.. _#1084: https://github.com/robotframework/SeleniumLibrary/issues/1084 |
| 201 | +.. _#1098: https://github.com/robotframework/SeleniumLibrary/issues/1098 |
| 202 | +.. _#1141: https://github.com/robotframework/SeleniumLibrary/issues/1141 |
| 203 | +.. _#1142: https://github.com/robotframework/SeleniumLibrary/issues/1142 |
| 204 | +.. _#1183: https://github.com/robotframework/SeleniumLibrary/issues/1183 |
| 205 | +.. _#1073: https://github.com/robotframework/SeleniumLibrary/issues/1073 |
| 206 | +.. _#1090: https://github.com/robotframework/SeleniumLibrary/issues/1090 |
| 207 | +.. _#1185: https://github.com/robotframework/SeleniumLibrary/issues/1185 |
| 208 | +.. _#1186: https://github.com/robotframework/SeleniumLibrary/issues/1186 |
| 209 | +.. _#1187: https://github.com/robotframework/SeleniumLibrary/issues/1187 |
| 210 | +.. _#323: https://github.com/robotframework/SeleniumLibrary/issues/323 |
| 211 | +.. _#757: https://github.com/robotframework/SeleniumLibrary/issues/757 |
| 212 | +.. _#763: https://github.com/robotframework/SeleniumLibrary/issues/763 |
| 213 | +.. _#905: https://github.com/robotframework/SeleniumLibrary/issues/905 |
| 214 | +.. _#1177: https://github.com/robotframework/SeleniumLibrary/issues/1177 |
| 215 | +.. _#1136: https://github.com/robotframework/SeleniumLibrary/issues/1136 |
0 commit comments