Установка selenium python на windows

Supported Python Versions¶

• Python 3.8+

Installing¶

If you have pip on your system, you can simply install or upgrade the Python bindings:

Alternately, you can download the source distribution from PyPI <https://pypi.org/project/selenium/#files>, unarchive it, and run:

Note: You may want to consider using virtualenv to create isolated Python environments.

Example 0:¶

• open a new Firefox browser
• load the page at the given URL

from selenium import webdriver

browser = webdriver.Firefox()
browser.get('http://selenium.dev/')

Example 1:¶

• open a new Firefox browser
• load the Yahoo homepage
• search for “seleniumhq”
• close the browser

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys

browser = webdriver.Firefox()

browser.get('http://www.yahoo.com')
assert 'Yahoo' in browser.title

elem = browser.find_element(By.NAME, 'p')  # Find the search box
elem.send_keys('seleniumhq' + Keys.RETURN)

browser.quit()

Example 2:¶

Selenium WebDriver is often used as a basis for testing web applications. Here is a simple example using Python’s standard unittest library:

import unittest
from selenium import webdriver

class GoogleTestCase(unittest.TestCase):

    def setUp(self):
        self.browser = webdriver.Firefox()
        self.addCleanup(self.browser.quit)

    def test_page_title(self):
        self.browser.get('http://www.google.com')
        self.assertIn('Google', self.browser.title)

if __name__ == '__main__':
    unittest.main(verbosity=2)

Selenium Server (optional)¶

For normal WebDriver scripts (non-Remote), the Java server is not needed.

However, to use Selenium Webdriver Remote , you need to also run the Selenium server. The server requires a Java Runtime Environment (JRE).

Download the server separately, from: https://www.selenium.dev/downloads/

Run the server from the command line:

java -jar selenium-server-4.14.0.jar

Then run your Python client scripts.

Contributing¶

• Create a branch for your work
• Ensure tox is installed (using a virtualenv is recommended)
• python3.8 -m venv .venv && . .venv/bin/activate && pip install tox
• After making changes, before committing execute tox -e linting
• If tox exits 0, commit and push otherwise fix the newly introduced breakages.
• flake8 requires manual fixes
• black will often rewrite the breakages automatically, however the files are unstaged and should staged again.
• isort will often rewrite the breakages automatically, however the files are unstaged and should staged again.

1.1. Introduction¶

Selenium Python bindings provides a simple API to write functional/acceptance
tests using Selenium WebDriver. Through Selenium Python API you can access all
functionalities of Selenium WebDriver in an intuitive way.

Selenium Python bindings provide a convenient API to access Selenium WebDrivers
like Firefox, Ie, Chrome, Remote etc. The current supported Python versions are
3.5 and above.

This documentation explains Selenium 2 WebDriver API. Selenium 1 / Selenium RC
API is not covered here.

1.2. Installing Python bindings for Selenium¶

Use pip to install the selenium
package. Python 3 has pip available in the standard library. Using pip, you can
install selenium like this:

You may consider using virtualenv to
create isolated Python environments. Python 3 has venv which is almost the same as
virtualenv.

You can also download Python bindings for Selenium from the PyPI page for
selenium package. and install
manually.

1.3. Instructions for Windows users¶

1. Install Python 3 using the MSI available in python.org download page.

2. Start a command prompt using the cmd.exe program and run the pip
   command as given below to install selenium.

   C:\Python39\Scripts\pip.exe install selenium
   

Now you can run your test scripts using Python. For example, if you have
created a Selenium based script and saved it inside
C:\my_selenium_script.py, you can run it like this:

C:\Python39\python.exe C:\my_selenium_script.py

1.4. Installing from Git sources¶

To build Selenium Python from the source code, clone the official repository. It contains the source code for
all official Selenium flavors, like Python, Java, Ruby and others. The Python
code resides in the /py directory. To build, you will also need the Bazel build system.

To build a Wheel from the sources, run the following command from the repository
root:

bazel //py:selenium-wheel

This command will prepare the source code with some preprocessed JS files needed
by some webdriver modules and build the .whl package inside the
./bazel-bin/py/ directory. Afterwards, you can use pip to install it.

1.5. Drivers¶

Selenium requires a driver to interface with the chosen browser. Firefox, for
example, requires geckodriver, which needs to be installed
before the below examples can be run. Make sure it’s in your PATH, e. g.,
place it in /usr/bin or /usr/local/bin.

Failure to observe this step will give you an error
selenium.common.exceptions.WebDriverException: Message: ‘geckodriver’
executable needs to be in PATH.

Other supported browsers will have their own drivers available. Links to some of
the more popular browser drivers follow.

For more information about driver installation, please refer the official
documentation.

Starting from version 4.6.0 (November 4, 2022)
selenium comes with Selenium Manager packed in distribution.

Selenium Manager is a new tool that helps to get a working environment
to run Selenium out of the box:

• automatically discovers, downloads, and caches the drivers
  required by Selenium when these drivers are unavailable;
• automatically discovers, downloads, and caches the browsers
  driven with Selenium (Chrome, Firefox, and Edge)
  when these browsers are not installed in the local system.

For example, to see the result of Selenium Manager work
just run any selenium script without previous driver setup
and explore ~/.cache/selenium.

More about Selenium Manager you can read in the
documentation
and
blog.

1.6. Downloading Selenium server¶

Selenium server is a Java program. Java Runtime Environment (JRE) 1.6 or newer
version is recommended to run Selenium server.

You can download Selenium server 2.x from the download page of selenium website. The file name should be something like
this: selenium-server-standalone-2.x.x.jar. You can always download the
latest 2.x version of Selenium server.

If Java Runtime Environment (JRE) is not installed in your system, you can
download the JRE from the Oracle website. If you
are using a GNU/Linux system and have root access in your system, you can also
use your operating system instructions to install JRE.

If java command is available in the PATH (environment variable), you can start
the Selenium server using this command:

java -jar selenium-server-standalone-2.x.x.jar

Replace 2.x.x with the actual version of Selenium server you downloaded from
the site.

If JRE is installed as a non-root user and/or if it is not available in the PATH
(environment variable), you can type the relative or absolute path to the java
command. Similarly, you can provide a relative or absolute path to Selenium
server jar file. Then, the command will look something like this:

/path/to/java -jar /path/to/selenium-server-standalone-2.x.x.jar

Сфера применения