1 | ## node-geckodriver [![Build Status: Linux](https://travis-ci.org/vladikoff/node-geckodriver.svg?branch=master)](https://travis-ci.org/vladikoff/node-geckodriver) [![Build status: Windows](https://ci.appveyor.com/api/projects/status/s1e19ujtssxcn268/branch/master?svg=true)](https://ci.appveyor.com/project/vladikoff/node-geckodriver/branch/master) [![npm package](https://img.shields.io/npm/v/geckodriver.svg)](https://www.npmjs.com/package/geckodriver)
|
2 |
|
3 | > Downloader for [github.com/mozilla/geckodriver/releases](https://github.com/mozilla/geckodriver/releases)
|
4 |
|
5 | This puts `geckodriver` or `geckodriver.exe` into root of this module.
|
6 |
|
7 | ## Install
|
8 |
|
9 | ```
|
10 | npm install geckodriver
|
11 | ```
|
12 |
|
13 | ## Usage
|
14 |
|
15 | There are several ways to use this module:
|
16 |
|
17 | ### Use the provided `geckodriver` from `bin` directory.
|
18 |
|
19 | ```
|
20 | bin/geckodriver [args]
|
21 | ```
|
22 |
|
23 | ### Use it by requiring:
|
24 |
|
25 | ```
|
26 | require('geckodriver');
|
27 | ```
|
28 |
|
29 | ### Use it by setting WebDriver capabilities:
|
30 |
|
31 | ```
|
32 | profile.setPreference('marionette', true);
|
33 | // Add log level if needed:
|
34 | // profile.setPreference('marionette.logging', 'TRACE');
|
35 | ```
|
36 |
|
37 | ### Use it globally:
|
38 |
|
39 | ```
|
40 | npm install -g geckodriver
|
41 | geckodriver [args]
|
42 | ```
|
43 |
|
44 | Note: This installs a `geckodriver` shell script that runs the executable, but on Windows, selenium-webdriver looks for `geckodriver.exe`. To use a global installation of this package with selenium-webdriver on Windows, copy or link `geckodriver.exe` to a location on your PATH (such as the NPM bin directory) after installing this package:
|
45 |
|
46 | ```
|
47 | mklink %USERPROFILE%\AppData\Roaming\npm\geckodriver.exe %USERPROFILE%\AppData\Roaming\npm\node_modules\geckodriver\geckodriver.exe
|
48 | ```
|
49 |
|
50 | ## Setting a CDN URL for binary download
|
51 |
|
52 | To set an alternate CDN location for geckodriver binaries, set the `GECKODRIVER_CDNURL` like this:
|
53 |
|
54 | ```
|
55 | GECKODRIVER_CDNURL=https://INTERNAL_CDN/geckodriver/download
|
56 | ```
|
57 |
|
58 | Binaries on your CDN should be located in a subdirectory of the above base URL. For example, `/vxx.xx.xx/*.tar.gz` should be located under `/geckodriver/download` above.
|
59 |
|
60 | Alternatively, you can add the same property to your `.npmrc` file.
|
61 |
|
62 | Default location is set to https://github.com/mozilla/geckodriver/releases/download
|
63 |
|
64 | ## Setting a PROXY URL
|
65 |
|
66 | Use `HTTPS_PROXY` or `HTTP_PROXY` to set your proxy url.
|
67 |
|
68 | ## Related Projects
|
69 |
|
70 | * [node-chromedriver](https://github.com/giggio/node-chromedriver)
|
71 |
|
72 | ## Versions
|
73 |
|
74 | * [npm module version] - [geckodriver version]
|
75 | * 1.14.x - geckodriver 0.23.0
|
76 | * 1.13.x - geckodriver 0.22.0
|
77 | * 1.12.x - geckodriver 0.21.0
|
78 | * 1.11.x - geckodriver 0.20.0
|
79 | * 1.10.x - geckodriver 0.19.1
|
80 | * 1.9.x - geckodriver 0.19.0
|
81 | * 1.8.x - geckodriver 0.18.0
|
82 | * 1.7.x - geckodriver 0.17.0
|
83 | * 1.6.x - geckodriver 0.16.1
|
84 | * 1.5.x - geckodriver 0.15.0
|
85 | * 1.4.x - geckodriver 0.14.0
|
86 | * 1.3.x - geckodriver 0.13.0
|
87 | * 1.2.x - geckodriver 0.11.1
|
88 | * 1.1.x - geckodriver 0.10
|
89 |
|
90 | ## Changelog
|
91 |
|
92 | * 1.14.1 - installation fixes
|
93 | * 1.14.0 - geckodriver 0.23.0
|
94 | * 1.13.0 - geckodriver 0.22.0
|
95 | * 1.12.2 - add proxy settings
|
96 | * 1.12.1 - adm-zip security fix
|
97 | * 1.12.0 - geckodriver 0.21.0
|
98 | * 1.11.0 - geckodriver 0.20.0
|
99 | * 1.10.0 - geckodriver 0.19.1, switch tar package, enable Win32 builds again, process.env.npm_config_geckodriver_cdnurl support
|
100 | * 1.9.0 - updated to geckodriver 0.19.0 32-bit windows support removed.
|
101 | * 1.8.1 - added geckodriver.exe bin for Windows
|
102 | * 1.8.0 - updated to geckodriver 0.18.0
|
103 | * 1.7.1 - 'GECKODRIVER_CDNURL' support added.
|
104 | * 1.7.0 - updated to geckodriver 0.17.0 32-bit linux support added.
|
105 | * 1.6.1 - updated to geckodriver 0.16.1
|
106 | * 1.6.0 - updated to geckodriver 0.16.0. 32-bit linux support removed.
|
107 | * 1.5.0 - updated to geckodriver 0.15.0.
|
108 | * 1.4.0 - updated to geckodriver 0.14.0.
|
109 | * 1.3.0 - updated to geckodriver 0.13.0.
|
110 | * 1.2.1 - added support for Linux 32-bit.
|
111 | * 1.2.0 - updated to geckodriver 0.11.1.
|
112 | * 1.1.3 - adds Windows support, fixes Windows tests.
|
113 | * 1.1.2 - fixed `require` by pointing `package.json main` property to the `lib` file.
|
114 | * 1.1.0 - programmatic usage, added `bin` support.
|
115 | * 1.0.0 - init release
|