========================
SeleniumLibrary 6.3.0rc1
========================


.. default-role:: code


SeleniumLibrary_ is a web testing library for `Robot Framework`_ that utilizes
the Selenium_ tool internally. SeleniumLibrary 6.3.0rc1 is a new release with
**UPDATE** enhancements and bug fixes. **ADD more intro stuff...**

All issues targeted for SeleniumLibrary v6.3.0 can be found
from the `issue tracker`_.

If you have pip_ installed, just run

::

   pip install --pre --upgrade robotframework-seleniumlibrary

to install the latest available release or use

::

   pip install robotframework-seleniumlibrary==6.3.0rc1

to install exactly this version. Alternatively you can download the source
distribution from PyPI_ and install it manually.

SeleniumLibrary 6.3.0rc1 was released on Saturday March 30, 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`_, rc 1)
  New kyeword which minimizes the current browser window.

- Add keywords to fetch differentiated element Attribute or Property (`#1822`_, rc 1)
  The older ``Get Element Attribute`` keyword uses the Selenium getAttribute() method which,
  as `this SauceLabs article <https://saucelabs.com/resources/blog/selenium-4-new-element-attribute-and-property-methods>`_ 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.

Acknowledgements
================

- `Luciano Martorella <https://github.com/lmartorella>`_ contributing the new
  minimize keyword (`#1741`_, rc 1)
- `Yuri Verweij <https://github.com/yuriverweij>`_  and `Lisa Crispin <https://lisacrispin.com/>`_
  for reviewing changes and addition to Attribute or Property keywords (`#1822`_, rc 1)
- `Noam Manos <https://github.com/manosnoam>`_ for reporting the issues where
  the Open Browser 'Options' object has no attribute '' (`#1877`_, rc 1)
- Yuri for helping update the contribution guide (`#1881`_, rc 1)

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
      - Added
    * - `#1741`_
      - enhancement
      - high
      - Added minimize keyword
      - rc�1
    * - `#1822`_
      - enhancement
      - high
      - Add keywords to fetch differentiated element Attribute or Property
      - rc�1
    * - `#1877`_
      - enhancement
      - medium
      - Open Browser 'Options' object has no attribute ''
      - rc�1
    * - `#1881`_
      - ---
      - medium
      - Update contribution guide
      - rc�1

Altogether 4 issues. View on the `issue tracker <https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av6.3.0>`__.

.. _#1741: https://github.com/robotframework/SeleniumLibrary/issues/1741
.. _#1822: https://github.com/robotframework/SeleniumLibrary/issues/1822
.. _#1877: https://github.com/robotframework/SeleniumLibrary/issues/1877
.. _#1881: https://github.com/robotframework/SeleniumLibrary/issues/1881
