Left: | ||
Right: |
OLD | NEW |
---|---|
1 [![Pipeline status](https://gitlab.com/eyeo/adblockplus/adblockpluschrome/badges /master/build.svg)](https://gitlab.com/eyeo/adblockplus/adblockpluschrome/pipeli nes/) | 1 [![Pipeline status](https://gitlab.com/eyeo/adblockplus/adblockpluschrome/badges /master/build.svg)](https://gitlab.com/eyeo/adblockplus/adblockpluschrome/pipeli nes/) |
2 | 2 |
3 Adblock Plus for Chrome, Opera, Microsoft Edge and Firefox | 3 Adblock Plus for Chrome, Opera, Microsoft Edge and Firefox |
4 ========================================================== | 4 ========================================================== |
5 | 5 |
6 This repository contains the platform-specific Adblock Plus source code for | 6 This repository contains the platform-specific Adblock Plus source code for |
7 Chrome, Opera, Microsoft Edge and Firefox. It can be used to build | 7 Chrome, Opera, Microsoft Edge and Firefox. It can be used to build |
8 Adblock Plus for these platforms, generic Adblock Plus code will be extracted | 8 Adblock Plus for these platforms, generic Adblock Plus code will be extracted |
9 from other repositories automatically (see _dependencies_ file). | 9 from other repositories automatically (see _dependencies_ file). |
10 | 10 |
(...skipping 86 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
97 The unit tests will run automatically once the page loads. | 97 The unit tests will run automatically once the page loads. |
98 | 98 |
99 ### External test runner | 99 ### External test runner |
100 | 100 |
101 There is also an external test runner that can be invoked from the | 101 There is also an external test runner that can be invoked from the |
102 command line in order to run the unit tests along some integration | 102 command line in order to run the unit tests along some integration |
103 tests on different browsers, and automatically run the linter as well. | 103 tests on different browsers, and automatically run the linter as well. |
104 | 104 |
105 On Windows, in order to use the test runner, in addition to setting up a Linux | 105 On Windows, in order to use the test runner, in addition to setting up a Linux |
106 environment as outlined above, you need to have Node.js installed in your native | 106 environment as outlined above, you need to have Node.js installed in your native |
107 Windows environment. Then run the commands below from within PowerShell or | 107 Windows environment. |
108 Also you are going to have to install [Microsoft Webdriver](https://developer.mi crosoft.com/en-us/microsoft-edge/tools/webdriver/) | |
Sebastian Noack
2018/12/06 03:47:30
This will be outdated very soon, as on Insider bui
| |
109 and ensure that it can be found on your path. | |
110 Then run the commands below from within PowerShell or | |
108 cmd.exe (unlike when building the extension which needs to be done from Bash). | 111 cmd.exe (unlike when building the extension which needs to be done from Bash). |
109 | 112 |
113 | |
110 Make sure the required packages are installed and up-to-date: | 114 Make sure the required packages are installed and up-to-date: |
111 | 115 |
112 npm install | 116 npm install |
113 | 117 |
114 Start the testing process for all browsers: | 118 Start the testing process for all browsers: |
115 | 119 |
116 npm test | 120 npm test |
117 | 121 |
118 Start the testing process in one browser only: | 122 Start the testing process in one browser only: |
119 | 123 |
120 npm test -- -g <Firefox|Chromium> | 124 npm test -- -g <Firefox|Chromium|Edge> |
121 | 125 |
122 By default it downloads (and caches) and runs the tests against the | 126 By default it downloads (and caches) and runs the tests against the |
123 oldest compatible version and the latest release version of each browser. | 127 oldest compatible version and the latest release version of each browser. |
124 In order to run the tests against a different version set the CHROMIUM_BINARY | 128 In order to run the tests against a different version set the CHROMIUM_BINARY |
125 or FIREFOX_BINARY environment variables. Following values are accepted: | 129 or FIREFOX_BINARY environment variables. Following values are accepted: |
126 | 130 |
geo
2018/12/05 13:35:27
Maybe I should mention that for Edge, we always te
| |
127 * `installed` | 131 * `installed` |
128 * Uses the version installed on the system. | 132 * Uses the version installed on the system. |
129 * `path:<path>` | 133 * `path:<path>` |
130 * Uses the binary located at the given path. | 134 * Uses the binary located at the given path. |
131 * `download:<version>` | 135 * `download:<version>` |
132 * Downloads the given version (for Firefox the version must be in the | 136 * Downloads the given version (for Firefox the version must be in the |
133 form `<major>.<minor>`, for Chromium this must be the revision number). | 137 form `<major>.<minor>`, for Chromium this must be the revision number). |
134 | 138 |
135 Linting | 139 Linting |
136 ------- | 140 ------- |
137 | 141 |
138 You can lint the code using [ESLint](http://eslint.org). | 142 You can lint the code using [ESLint](http://eslint.org). |
139 | 143 |
140 You will need to setup first. This will install our configuration | 144 You will need to setup first. This will install our configuration |
141 [eslint-config-eyeo](https://hg.adblockplus.org/codingtools/file/tip/eslint-conf ig-eyeo) | 145 [eslint-config-eyeo](https://hg.adblockplus.org/codingtools/file/tip/eslint-conf ig-eyeo) |
142 and everything needed after you run: | 146 and everything needed after you run: |
143 | 147 |
144 npm install | 148 npm install |
145 | 149 |
146 Then you can run to lint the code: | 150 Then you can run to lint the code: |
147 | 151 |
148 npm run lint | 152 npm run lint |
OLD | NEW |