From 43a97878ce14b72f0981164f87f2e35e14151312 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 11:22:09 +0200 Subject: Adding upstream version 110.0.1. Signed-off-by: Daniel Baumann --- testing/web-platform/tests/web-nfc/README.md | 29 ++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 testing/web-platform/tests/web-nfc/README.md (limited to 'testing/web-platform/tests/web-nfc/README.md') diff --git a/testing/web-platform/tests/web-nfc/README.md b/testing/web-platform/tests/web-nfc/README.md new file mode 100644 index 0000000000..b51018d68f --- /dev/null +++ b/testing/web-platform/tests/web-nfc/README.md @@ -0,0 +1,29 @@ +The `nfc-helpers.js` requires an implementation of +the `WebNFCTest` interfaces, which should emulate platform Web NFC backends. + +The `WebNFCTest` interface is defined as: + +``` + class NFCTestChromium { + initialize(); // Sets up the testing environment. + async reset(); // Frees the resources. + getMockNFC(); // Returns `MockNFC` interface. + }; + + class MockNFC { + setHWStatus(number status); // Sets the hardware status. + setReadingMessage(NDEFMessageInit message); // Sets message that is used to deliver NFC reading updates. + setPendingPushCompleted(boolean result); // Sets if the pending push is completed. + setPendingMakeReadOnlyCompleted(boolean result); // Sets if the pending makeReadOnly is completed. + pushedMessage(); // Gets the pushed `NDEFMessageSource`. + writeOptions(); // Gets the pushed `NDEFWriteOptions`. + simulateNonNDEFTagDiscovered(); // Simulates that the NFC device discovered does not expose NDEF technology. + setIsFormattedTag(boolean isFormatted); // Sets if the NFC tag has formatted NDEF message. + }; +``` + +The Chromium implementation of the `WebNFCTest` interface is located in +[nfc-mock.js](../resources/chromium/nfc-mock.js). + +Other browser vendors should provide their own implementations of +the `WebNFCTest` interfaces. -- cgit v1.2.3