e2e/docs/internet-explorer.md (view raw)
1### Internet Explorer
2
3**Please Note:**
4This guide assumes that a system with Windows 10 has been set up.
5
6Microsoft provides
7[free Windows 10 virtual machines](https://developer.microsoft.com/en-us/microsoft-edge/tools/vms/)
8(that expire after 90 days) that can be used to test IE11 and Microsoft Edge
9Legacy.
10
11To run the tests with Internet Explorer, follow these steps:
12
131. Set "Change the size of text, apps, and other items" to 100% in Windows
14 Display Settings.
15 If the option is grayed out, make sure the graphics configuration allows
16 changing the scaling setting (see e.g.
17 [Parallels article #123951](https://kb.parallels.com/en/123951)).
18
192. Make sure the Internet Explorer `Zoom` level is set to `100%` so that the
20 native mouse events can be set to the correct coordinates.
21
223. Create a `.env` file in the same directory as
23 [docker-compose.yml](docker-compose.yml) and add the following environment
24 variables:
25
26 ```sh
27 SERVER_HOST=<DOCKER_HOST_IP>
28 SERVER_PORT=8080
29 WINDOWS_HOST=<WINDOWS_HOST_IP>
30 WINDOWS_ASSETS_DIR=C:\Users\<USERNAME>\Desktop\assets\
31 ```
32
33 Make sure that the `DOCKER_HOST_IP` is accessible from the Windows machine
34 and the `WINDOWS_HOST_IP` is accessible from a Docker container (see also the
35 [FAQ](FAQ.md)).
36 Also make sure that `WINDOWS_ASSETS_DIR` points to a valid folder path and
37 ends with a backslash.
38
394. Edit the `example` host entry in [etc/windows.hosts](etc/windows.hosts) and
40 set its IP address to the `SERVER_HOST` IP defined in the `.env` file.
41
425. Copy [bin/webdriver.ps1](bin/webdriver.ps1) and
43 [etc/windows.hosts](etc/windows.hosts) to the same folder in the Windows
44 machine (e.g. the Desktop).
45 Also copy the files in the `assets` directory to the folder defined as
46 `WINDOWS_ASSETS_DIR`.
47
486. Create a shortcut to `webdriver.ps1` (via "Right-Click" → "Create shortcut"),
49 then open the properties dialog for the shortcut (via "Right-Click" →
50 "Properties") and set the `Target` property to the following value:
51
52 ```bat
53 powershell -ExecutionPolicy ByPass -File webdriver.ps1
54 ```
55
56 Click "OK" to save the changes to the shortcut.
57
587. Double-Click on the webdriver shortcut to setup and start the servers.
59 Allow `Microsoft WebDriver`, `nginx` and `MJPEGServer` to communicate on all
60 networks in the Windows Defender Firewall dialog.
61
628. Run the tests with Internet Explorer:
63 ```sh
64 docker-compose run --rm wdio conf/internet-explorer.js
65 ```