test_framework
/
SeleniumBase
mirror of https://github.com/seleniumbase/SeleniumBase.git
3
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
SeleniumBase/help_docs/mobile_testing.md

90 lines
3.2 KiB
Markdown
Raw Normal View History

Update the docs
2022-11-05 13:27:22 +08:00
<!-- SeleniumBase Docs -->
Update the documentation
2023-10-15 04:41:09 +08:00
## [<img src="https://seleniumbase.github.io/img/logo6.png" title="SeleniumBase" width="32">](https://github.com/seleniumbase/SeleniumBase/) Mobile Mode / Mobile Testing
Update the docs
2020-02-05 14:59:06 +08:00
Update the docs
2020-08-06 04:12:02 +08:00
Use ``--mobile`` to run SeleniumBase tests using Chrome's mobile device emulator with default values for Device Metrics and User-Agent.
Update the docs
2020-08-06 04:06:37 +08:00
<b>Here's an example mobile test:</b>
Update the docs
2020-08-06 04:17:40 +08:00
[SeleniumBase/examples/test_skype_site.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_skype_site.py)
Update the docs
2020-05-24 14:38:50 +08:00
Update the docs
2020-08-06 04:06:37 +08:00
```bash
pytest test_skype_site.py --mobile
```
Update the docs
2020-10-22 21:37:35 +08:00
Update the documentation
2022-12-24 11:59:16 +08:00
[<img src="https://seleniumbase.github.io/cdn/gif/skype_mobile_test_2.gif" title="SeleniumBase Mobile Testing">](https://seleniumbase.github.io/cdn/gif/skype_mobile_test_2.gif)
Update the docs
2020-08-06 04:06:37 +08:00
To configure Device Metrics, use:
Update the docs
2020-10-22 21:37:35 +08:00
Update the docs
2020-05-24 14:38:50 +08:00
```bash
--metrics="CSS_Width,CSS_Height,Pixel_Ratio"
```
Update the docs
2020-08-06 04:06:37 +08:00
To configure the User-Agent, use:
Update the docs
2020-10-22 21:37:35 +08:00
Update the docs
2020-05-24 14:38:50 +08:00
```bash
--agent="USER-AGENT-STRING"
```
Update the docs
2020-02-05 14:59:06 +08:00
Update the docs
2020-08-06 04:06:37 +08:00
To find real values for Device Metrics, see:
Update the docs
2020-10-22 21:37:35 +08:00
Update the docs
2020-05-24 14:38:50 +08:00
* [Device Metrics List](https://gist.github.com/sidferreira/3f5fad525e99b395d8bd882ee0fd9d00)
Update the docs
2020-02-05 14:59:06 +08:00
Update the docs
2020-08-06 04:21:26 +08:00
To find real User-Agent strings, see:
Update the docs
2020-10-22 21:37:35 +08:00
Update the docs
2020-05-24 14:38:50 +08:00
* [User Agent Strings List](https://developers.whatismybrowser.com/useragents/explore/)
Update the docs
2020-02-05 14:59:06 +08:00
--------
Update the docs
2020-10-22 21:37:35 +08:00
<b>Here's another example of a mobile test:</b>
[SeleniumBase/examples/test_swag_labs.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/test_swag_labs.py)
```bash
pytest test_swag_labs.py --mobile
```
Update the documentation
2022-11-27 04:43:30 +08:00
[<img src="https://seleniumbase.github.io/cdn/gif/swag_mobile_2.gif" alt="SeleniumBase Mobile Testing" title="SeleniumBase Mobile Testing">](https://seleniumbase.github.io/cdn/gif/swag_mobile.gif)
Update the docs
2020-10-22 21:37:35 +08:00
<b>Here's an example of configuring mobile settings for that test:</b>
Update the docs
2020-02-05 14:59:06 +08:00
```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
Change the documentation for mobile device metrics
2022-06-08 11:30:11 +08:00
pytest test_swag_labs.py --mobile --metrics="360,640,2"
Update the docs
2020-02-05 14:59:06 +08:00
# Run mobile tests specifying the user agent
pytest test_swag_labs.py --mobile --agent="Mozilla/5.0 (Linux; Android 9; Pixel 3 XL)"
```
--------
Update the documentation
2023-10-15 04:41:09 +08:00
For some [SeleniumBase Syntax Formats](https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/syntax_formats.md), you can also use `mobile=True` to run tests in Mobile Mode:
```python
from seleniumbase import Driver
driver = Driver(mobile=True)
try:
driver.open("https://www.skype.com/en/get-skype/")
driver.assert_element('[aria-label="Microsoft"]')
driver.assert_text("Download Skype", "h1")
driver.highlight("div.appBannerContent")
driver.highlight("h1")
driver.assert_text("Skype for Mobile", "h2")
driver.highlight("h2")
driver.highlight("#get-skype-0")
driver.highlight_click("span[data-dropdown-icon]")
driver.highlight("#get-skype-0_android-download")
driver.highlight('[data-bi-id*="ios"]')
finally:
driver.quit()
```
--------
Update the docs
2020-05-24 14:38:50 +08:00
<p align="center"><div align="center"><a href="https://seleniumbase.io">
Update the docs
2020-10-03 01:25:12 +08:00
<img src="https://img.shields.io/badge/docs-%20seleniumbase.io-11BBDD.svg" alt="SeleniumBase.io Docs" /></a> <a href="https://github.com/seleniumbase/SeleniumBase"><img src="https://img.shields.io/badge/✅%20💛%20View%20Code-on%20GitHub%20🌎%20🚀-02A79E.svg" alt="SeleniumBase.io Docs" /></a></div></p>