Merge pull request #496 from seleniumbase/add-additional-scroll-methods

Add additional scroll methods

Author: mdmintz

README.md

@@ -1,4 +1,4 @@
-[<img src="https://cdn2.hubspot.net/hubfs/100006/fancy_logo_8.png" title="SeleniumBase" align="center" height="38">](https://github.com/seleniumbase/SeleniumBase/blob/master/README.md)<br />
+[<img src="https://cdn2.hubspot.net/hubfs/100006/fancy_logo_9.png" title="SeleniumBase" align="center" height="38">](https://github.com/seleniumbase/SeleniumBase/blob/master/README.md)<br />
 
 [<img src="https://img.shields.io/github/release/seleniumbase/SeleniumBase.svg?color=2277EE" alt="SeleniumBase" />](https://github.com/seleniumbase/SeleniumBase/releases) [<img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=22AAEE" alt=" " />](https://pypi.python.org/pypi/seleniumbase) [<img src="https://badges.gitter.im/seleniumbase/SeleniumBase.svg" alt=" " />](https://gitter.im/seleniumbase/SeleniumBase) [<img src="https://img.shields.io/travis/seleniumbase/SeleniumBase/master.svg" alt=" " />](https://travis-ci.org/seleniumbase/SeleniumBase) [<img src="https://github.com/seleniumbase/SeleniumBase/workflows/CI%20build/badge.svg">](https://github.com/seleniumbase/SeleniumBase/actions)<br />
 

help_docs/method_summary.md

@@ -172,6 +172,10 @@ self.scroll_to(selector, by=By.CSS_SELECTOR)
 
 self.slow_scroll_to(selector, by=By.CSS_SELECTOR)
 
+self.scroll_to_top()
+
+self.scroll_to_bottom()
+
 self.click_xpath(xpath)
 
 self.js_click(selector, by=By.CSS_SELECTOR, all_matches=False)

help_docs/mobile_testing.md

@@ -0,0 +1,38 @@
+[<img src="https://cdn2.hubspot.net/hubfs/100006/images/SeleniumBaseText_F.png" title="SeleniumBase" align="center" height="40">](https://github.com/seleniumbase/SeleniumBase/blob/master/README.md)
+## <img src="https://cdn2.hubspot.net/hubfs/100006/images/super_square_logo_3a.png" title="SeleniumBase" height="32"> Mobile Testing
+
+Use ``--mobile`` to run your SeleniumBase tests using Chrome's (or Edge's) mobile device emulator with default values for device metrics (CSS Width, CSS Height, Pixel-Ratio) and user agent.
+
+To configure the mobile device metrics, use ``--metrics="CSS_Width,CSS_Height,Pixel_Ratio"``. To configure the user agent, use ``--agent="USER-AGENT-STRING"``.
+
+To find real values for device metrics, [see this GitHub Gist](https://gist.github.com/sidferreira/3f5fad525e99b395d8bd882ee0fd9d00). For a list of available user agent strings, [check out this page](https://developers.whatismybrowser.com/useragents/explore/).
+
+--------
+
+Here's an example of running a mobile test (See https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_skype_site.py):
+
+```bash
+pytest test_skype_site.py --mobile --browser=edge
+```
+[<img src="https://cdn2.hubspot.net/hubfs/100006/images/skype_mobile_test_2.gif" title="SeleniumBase Mobile Testing">](https://cdn2.hubspot.net/hubfs/100006/images/skype_mobile_test_2.gif)
+
+
+--------
+
+Here's another example of running a mobile test (https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_swag_labs.py), which demonstrates using ``--metrics`` and ``--agent`` with ``--mobile``.:
+
+```bash
+# Run tests using Chrome's mobile device emulator (default settings)
+pytest test_swag_labs.py --mobile
+
+# Run mobile tests specifying CSS Width, CSS Height, and Pixel-Ratio
+pytest test_swag_labs.py --mobile --metrics="411,731,3"
+
+# Run mobile tests specifying the user agent
+pytest test_swag_labs.py --mobile --agent="Mozilla/5.0 (Linux; Android 9; Pixel 3 XL)"
+```
+[<img src="https://cdn2.hubspot.net/hubfs/100006/images/swag_labs_gif.gif" title="SeleniumBase Mobile Testing">](https://cdn2.hubspot.net/hubfs/100006/images/swag_labs_gif.gif)
+
+--------
+
+If you're new to SeleniumBase, read https://github.com/seleniumbase/SeleniumBase to help you get started.

requirements.txt

@@ -39,7 +39,7 @@ pymysql==0.9.3
 pyotp==2.3.0
 boto==2.49.0
 cffi>=1.13.2
-tqdm>=4.42.0
+tqdm>=4.42.1
 flake8==3.7.9
 certifi>=2019.11.28
 pdfminer.six==20191110;python_version<"3.5"

seleniumbase/fixtures/base_case.py

@@ -1826,6 +1826,24 @@ def slow_scroll_to(self, selector, by=By.CSS_SELECTOR, timeout=None):
                 selector, by=by, timeout=timeout)
             self.__slow_scroll_to_element(element)
 
+    def scroll_to_top(self):
+        scroll_script = "window.scrollTo(0, 0);"
+        try:
+            self.execute_script(scroll_script)
+            time.sleep(0.012)
+            return True
+        except Exception:
+            return False
+
+    def scroll_to_bottom(self):
+        scroll_script = "window.scrollTo(0, 10000);"
+        try:
+            self.execute_script(scroll_script)
+            time.sleep(0.012)
+            return True
+        except Exception:
+            return False
+
     def click_xpath(self, xpath):
         # Technically self.click() will automatically detect an xpath selector,
         # so self.click_xpath() is just a longer name for the same action.

setup.py

@@ -45,7 +45,7 @@
 
 setup(
     name='seleniumbase',
-    version='1.35.1',
+    version='1.35.2',
     description='Fast, Easy, and Reliable Browser Automation & Testing.',
     long_description=long_description,
     long_description_content_type='text/markdown',
@@ -121,7 +121,7 @@
         'pyotp==2.3.0',
         'boto==2.49.0',
         'cffi>=1.13.2',
-        'tqdm>=4.42.0',
+        'tqdm>=4.42.1',
         'flake8==3.7.9',
         'certifi>=2019.11.28',
         'pdfminer.six==20191110;python_version<"3.5"',