refactor: finish moving ssh-* scripts to own installers
[webi-installers/.git] / chromedriver / README.md
1 ---
2 title: ChromeDriver
3 homepage: https://chromedriver.chromium.org
4 tagline: |
5   ChromeDriver: WebDriver for Chrome
6 ---
7
8 To update or switch versions, run `webi chromedriver@stable` (or `@v2`, `@beta`,
9 etc).
10
11 ## Cheat Sheet
12
13 > WebDriver is an open source tool for automated testing of webapps across many
14 > browsers. ChromeDriver is a WebDriver created by the Chromium (Google Chrome)
15 > team - for Selenium and such.
16
17 You probably won't run `chromedriver` manually, but it must be installed for
18 some testing frameworks.
19
20 Also, **Chrome must be installed first** in order for ChromeDriver to work.
21
22 ### How to Install Chrome on Linux
23
24 On Debian (and Ubuntu) Linux you should be able to install Chrome with `dpkg`
25 and `apt`:
26
27 ```bash
28 wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
29 sudo dpkg -i google-chrome-stable_current_amd64.deb
30 sudo apt install -y google-chrome-stable
31 sudo apt --fix-broken install -y
32 ```
33
34 You may get an error like this:
35
36 ```txt
37 chromedriver: error while loading shared libraries: libnss3.so: cannot open shared object file: No such file or directory
38 ```
39
40 If so, try installing `chromium-browser`:
41
42 ```bash
43 sudo apt install -y chromium-browser
44 sudo apt --fix-broken install -y
45 ```
46
47 ### Other Notes
48
49 On Windows `chromedriver.exe` _should_ Just Work™.
50
51 On macOS you may need to install XCode Command Line Tools with
52 `xcode-select --install`.