File: safari.md

package info (click to toggle)
firefox-esr 78.15.0esr-1~deb11u1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 3,301,156 kB
  • sloc: cpp: 5,665,905; javascript: 4,798,386; ansic: 2,878,233; python: 977,004; asm: 270,347; xml: 181,456; java: 111,756; sh: 72,926; makefile: 21,819; perl: 13,380; cs: 4,725; yacc: 4,565; objc: 3,026; pascal: 1,787; lex: 1,720; ada: 1,681; exp: 505; php: 436; lisp: 260; awk: 152; ruby: 103; csh: 80; sed: 53; sql: 45
file content (47 lines) | stat: -rw-r--r-- 1,704 bytes parent folder | download | duplicates (24)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# Safari

To run Safari on macOS, some manual setup is required. Some steps are different
for Safari and Safari Technology Preview.

  * Allow Safari to be controlled by SafariDriver:
    * `safaridriver --enable` or
    * `"/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --enable`

  * Allow pop-up windows:
    * `defaults write com.apple.Safari WebKitJavaScriptCanOpenWindowsAutomatically 1` or
    * `defaults write com.apple.SafariTechnologyPreview WebKitJavaScriptCanOpenWindowsAutomatically 1`

  * Turn on additional experimental features Safari Technology Preview:
    * `defaults write com.apple.SafariTechnologyPreview ExperimentalServerTimingEnabled 1`

  * Trust the certificate:
    * `security add-trusted-cert -k "$(security default-keychain | cut -d\" -f2)" tools/certs/cacert.pem`

  * Set `no_proxy='*'` in your environment. This is a
    workaround for a known
    [macOS High Sierra issue](https://github.com/web-platform-tests/wpt/issues/9007).

Now, run the tests using the `safari` product:
```
./wpt run safari [test_list]
```

This will use the `safaridriver` found on the path, which will be stable Safari.
To run Safari Technology Preview instead, use the `--channel=preview` argument:
```
./wpt run --channel=preview safari [test_list]
```

## Debugging

To debug problems with `safaridriver`, add the `--webdriver-arg=--diagnose`
argument:
```
./wpt run --channel=preview --webdriver-arg=--diagnose safari [test_list]
```

The logs will be in `~/Library/Logs/com.apple.WebDriver/`.
See `man safaridriver` for more information.

To enable safaridriver diagnostics in Azure Pipelines, set
`safaridriver_diagnose` to `true` in `.azure-pipelines.yml`.