summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/webusb/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'testing/web-platform/tests/webusb/README.md')
-rw-r--r--testing/web-platform/tests/webusb/README.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/testing/web-platform/tests/webusb/README.md b/testing/web-platform/tests/webusb/README.md
new file mode 100644
index 0000000000..c19e8fa347
--- /dev/null
+++ b/testing/web-platform/tests/webusb/README.md
@@ -0,0 +1,17 @@
+# WebUSB Testing
+
+WebUSB testing relies on the [WebUSB Testing API] which must be
+provided by browsers under test.
+
+In this test suite `resources/usb-helpers.js` detects and triggers
+the API to be loaded as needed.
+
+The Chromium implementation is provided by
+`../resources/chromium/webusb-test.js` using [MojoJS].
+
+Tests with the "-manual" suffix do not use the test-only interface and expect a
+real hardware device to be connected. The specific characteristics of the device
+are described in each test.
+
+[MojoJS]: https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/testing/web_platform_tests.md#mojojs
+[WebUSB Testing API]: https://wicg.github.io/webusb/test/