@guidepup/playwright 0.8.1 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +34 -6
- package/package.json +3 -3
- package/yarn.lock +13 -13
package/README.md
CHANGED
|
@@ -8,15 +8,39 @@
|
|
|
8
8
|
<a href="https://github.com/guidepup/guidepup-playwright/blob/main/LICENSE"><img alt="@guidepup/playwright uses the MIT license" src="https://img.shields.io/github/license/guidepup/guidepup-playwright" /></a>
|
|
9
9
|
</p>
|
|
10
10
|
<p align="center">
|
|
11
|
-
|
|
11
|
+
Reliable automation for your screen reader a11y workflows in Playwright supporting:
|
|
12
12
|
</p>
|
|
13
|
+
<p align="center">
|
|
14
|
+
<a href="https://www.guidepup.dev/docs/api/class-voiceover"><b>VoiceOver on MacOS</b></a>
|
|
15
|
+
</p>
|
|
16
|
+
<p align="center">
|
|
17
|
+
<b>NVDA on Windows</b> - <a href="https://github.com/guidepup/guidepup/pull/33">Coming Soon!</a>
|
|
18
|
+
</p>
|
|
19
|
+
|
|
20
|
+
## Intro
|
|
21
|
+
|
|
22
|
+
A11y static analysis tools [only cover 25% of WCAG](https://karlgroves.com/web-accessibility-testing-what-can-be-tested-and-how/) and don't assure on the quality of the user experience for screen reader users. This means teams need to perform lots of manual tests with multiple screen readers to ensure great UX which can take a lot of time... **not anymore!**
|
|
23
|
+
|
|
24
|
+
With [Guidepup](https://www.guidepup.dev/) you can automate your screen reader test workflows the same you as would for mouse or keyboard based scenarios, no sweat!
|
|
25
|
+
|
|
26
|
+
## Quick Features
|
|
27
|
+
|
|
28
|
+
- **Full Control** - if a screen reader has a keyboard command, then Guidepup supports it.
|
|
29
|
+
- **Mirrors Real User Experience** - assert on what users really do and hear when using screen readers.
|
|
30
|
+
- **Framework Agnostic** - run with Jest, with Playwright, as an independent script, no vendor lock-in.
|
|
13
31
|
|
|
14
32
|
## Getting Started
|
|
15
33
|
|
|
34
|
+
Set up your environment for screen reader automation with [`@guidepup/setup`](https://github.com/guidepup/setup):
|
|
35
|
+
|
|
36
|
+
```console
|
|
37
|
+
npx @guidepup/setup
|
|
38
|
+
```
|
|
39
|
+
|
|
16
40
|
Install `@guidepup/playwright` to your project:
|
|
17
41
|
|
|
18
|
-
```
|
|
19
|
-
npm install --save-dev @guidepup/playwright
|
|
42
|
+
```console
|
|
43
|
+
npm install --save-dev @guidepup/playwright @playwright/test
|
|
20
44
|
```
|
|
21
45
|
|
|
22
46
|
And get cracking with your first screen reader tests in Playwright!
|
|
@@ -68,7 +92,7 @@ Check out the configuration this adds [in the voConfig.ts file](./src/voConfig.t
|
|
|
68
92
|
|
|
69
93
|
## Environment Setup
|
|
70
94
|
|
|
71
|
-
|
|
95
|
+
Set up your environment for screen-read automation with [`@guidepup/setup`](https://github.com/guidepup/setup):
|
|
72
96
|
|
|
73
97
|
```bash
|
|
74
98
|
npx @guidepup/setup
|
|
@@ -78,12 +102,16 @@ If you are using GitHub Actions, check out the dedicated [`guidepup/setup-action
|
|
|
78
102
|
|
|
79
103
|
```yaml
|
|
80
104
|
- name: Setup Environment
|
|
81
|
-
uses: guidepup/setup-action@0.
|
|
105
|
+
uses: guidepup/setup-action@0.8.1
|
|
82
106
|
```
|
|
83
107
|
|
|
108
|
+
## Documentation
|
|
109
|
+
|
|
110
|
+
Head over to the [Guidepup Website](https://www.guidepup.dev/) for guides, real world examples, environment setup, and complete Guidepup API documentation with examples.
|
|
111
|
+
|
|
84
112
|
## Example
|
|
85
113
|
|
|
86
|
-
Check out [this VoiceOver example](./example/).
|
|
114
|
+
Check out [this cross-browser VoiceOver example](./example/).
|
|
87
115
|
|
|
88
116
|
## See Also
|
|
89
117
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@guidepup/playwright",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"description": "Screen reader driver for Playwright tests.",
|
|
5
5
|
"main": "lib/index.js",
|
|
6
6
|
"typings": "lib/index.d.ts",
|
|
@@ -36,10 +36,10 @@
|
|
|
36
36
|
"test:webkit": "playwright test --config ./example/webkit.config.ts ./example/tests/webkit/"
|
|
37
37
|
},
|
|
38
38
|
"dependencies": {
|
|
39
|
-
"@guidepup/guidepup": "^0.
|
|
39
|
+
"@guidepup/guidepup": "^0.16.0"
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|
|
42
|
-
"@playwright/test": "^1.
|
|
42
|
+
"@playwright/test": "^1.30.0",
|
|
43
43
|
"@types/node": "^18.11.18",
|
|
44
44
|
"@typescript-eslint/eslint-plugin": "^5.5.0",
|
|
45
45
|
"@typescript-eslint/parser": "^5.5.0",
|
package/yarn.lock
CHANGED
|
@@ -24,10 +24,10 @@
|
|
|
24
24
|
minimatch "^3.1.2"
|
|
25
25
|
strip-json-comments "^3.1.1"
|
|
26
26
|
|
|
27
|
-
"@guidepup/guidepup@^0.
|
|
28
|
-
version "0.
|
|
29
|
-
resolved "https://registry.yarnpkg.com/@guidepup/guidepup/-/guidepup-0.
|
|
30
|
-
integrity sha512-
|
|
27
|
+
"@guidepup/guidepup@^0.16.0":
|
|
28
|
+
version "0.16.0"
|
|
29
|
+
resolved "https://registry.yarnpkg.com/@guidepup/guidepup/-/guidepup-0.16.0.tgz#a09841d8594d2b000c7b114a45332890da72c6e9"
|
|
30
|
+
integrity sha512-kHmhIAkFn05FYT/MgHBc4iXi6OVsiDeiY4g6mp77p0brcf9HZhcY+iko+bVhW2jPWuJNysVTUbDNlOYUsrM43w==
|
|
31
31
|
|
|
32
32
|
"@humanwhocodes/config-array@^0.11.8":
|
|
33
33
|
version "0.11.8"
|
|
@@ -87,13 +87,13 @@
|
|
|
87
87
|
"@nodelib/fs.scandir" "2.1.5"
|
|
88
88
|
fastq "^1.6.0"
|
|
89
89
|
|
|
90
|
-
"@playwright/test@^1.
|
|
91
|
-
version "1.
|
|
92
|
-
resolved "https://registry.yarnpkg.com/@playwright/test/-/test-1.
|
|
93
|
-
integrity sha512
|
|
90
|
+
"@playwright/test@^1.30.0":
|
|
91
|
+
version "1.30.0"
|
|
92
|
+
resolved "https://registry.yarnpkg.com/@playwright/test/-/test-1.30.0.tgz#8c0c4930ff2c7be7b3ec3fd434b2a3b4465ed7cb"
|
|
93
|
+
integrity sha512-SVxkQw1xvn/Wk/EvBnqWIq6NLo1AppwbYOjNLmyU0R1RoQ3rLEBtmjTnElcnz8VEtn11fptj1ECxK0tgURhajw==
|
|
94
94
|
dependencies:
|
|
95
95
|
"@types/node" "*"
|
|
96
|
-
playwright-core "1.
|
|
96
|
+
playwright-core "1.30.0"
|
|
97
97
|
|
|
98
98
|
"@tsconfig/node10@^1.0.7":
|
|
99
99
|
version "1.0.9"
|
|
@@ -855,10 +855,10 @@ picomatch@^2.3.1:
|
|
|
855
855
|
resolved "https://registry.yarnpkg.com/picomatch/-/picomatch-2.3.1.tgz#3ba3833733646d9d3e4995946c1365a67fb07a42"
|
|
856
856
|
integrity sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==
|
|
857
857
|
|
|
858
|
-
playwright-core@1.
|
|
859
|
-
version "1.
|
|
860
|
-
resolved "https://registry.yarnpkg.com/playwright-core/-/playwright-core-1.
|
|
861
|
-
integrity sha512-
|
|
858
|
+
playwright-core@1.30.0:
|
|
859
|
+
version "1.30.0"
|
|
860
|
+
resolved "https://registry.yarnpkg.com/playwright-core/-/playwright-core-1.30.0.tgz#de987cea2e86669e3b85732d230c277771873285"
|
|
861
|
+
integrity sha512-7AnRmTCf+GVYhHbLJsGUtskWTE33SwMZkybJ0v6rqR1boxq2x36U7p1vDRV7HO2IwTZgmycracLxPEJI49wu4g==
|
|
862
862
|
|
|
863
863
|
prelude-ls@^1.2.1:
|
|
864
864
|
version "1.2.1"
|