'use strict'; // These tests rely on the User Agent providing an implementation of // platform nfc backends. // // In Chromium-based browsers this implementation is provided by a polyfill // in order to reduce the amount of test-only code shipped to users. To enable // these tests the browser must be run with these options: // // --enable-blink-features=MojoJS,MojoJSTest let loadChromiumResources = Promise.resolve().then(() => { if (!window.MojoInterfaceInterceptor) { // Do nothing on non-Chromium-based browsers or when the Mojo bindings are // not present in the global namespace. return; } let chain = Promise.resolve(); [ '/gen/layout_test_data/mojo/public/js/mojo_bindings.js', '/gen/services/device/public/mojom/nfc.mojom.js', '/resources/chromium/nfc-mock.js', ].forEach(path => { let script = document.createElement('script'); script.src = path; script.async = false; chain = chain.then(() => new Promise(resolve => { script.onload = resolve; })); document.head.appendChild(script); }); return chain; }); async function initialize_nfc_tests() { if (typeof WebNFCTest === 'undefined') { await loadChromiumResources; } assert_true( typeof WebNFCTest !== 'undefined', 'WebNFC testing interface is not available.' ); let NFCTest = new WebNFCTest(); await NFCTest.initialize(); return NFCTest; } function nfc_test(func, name, properties) { promise_test(async t => { let NFCTest = await initialize_nfc_tests(); let mockTest = NFCTest.getMockNFC(); try { await func(t, mockTest); } finally { await NFCTest.reset(); }; }, name, properties); } const test_text_data = 'Test text data.'; const test_text_byte_array = new TextEncoder('utf-8').encode(test_text_data); const test_number_data = 42; const test_json_data = {level: 1, score: 100, label: 'Game'}; const test_url_data = 'https://w3c.github.io/web-nfc/'; const test_message_origin = 'https://127.0.0.1:8443'; const test_buffer_data = new ArrayBuffer(test_text_byte_array.length); const test_buffer_view = new Uint8Array(test_buffer_data).set(test_text_byte_array); const fake_tag_serial_number = 'c0:45:00:02'; const NFCHWStatus = {}; // OS-level NFC setting is ON NFCHWStatus.ENABLED = 1; // no NFC chip NFCHWStatus.NOT_SUPPORTED = NFCHWStatus.ENABLED + 1; // OS-level NFC setting OFF NFCHWStatus.DISABLED = NFCHWStatus.NOT_SUPPORTED + 1; function createMessage(records) { if (records !== undefined) { let message = {}; message.records = records; return message; } } function createRecord(recordType, mediaType, data) { let record = {}; if (recordType !== undefined) record.recordType = recordType; if (mediaType !== undefined) record.mediaType = mediaType; if (data !== undefined) record.data = data; return record; } function createTextRecord(text) { return createRecord('text', 'text/plain', text); } function createJsonRecord(json) { return createRecord('json', 'application/json', json); } function createOpaqueRecord(buffer) { return createRecord('opaque', 'application/octet-stream', buffer); } function createUrlRecord(url) { return createRecord('url', 'text/plain', url); } function createNFCPushOptions(target, timeout, ignoreRead, compatibility) { return { target, timeout, ignoreRead, compatibility}; } // Compares NDEFMessageSource that was provided to the API // (e.g. NFCWriter.push), and NDEFMessage that was received by the // mock NFC service. function assertNDEFMessagesEqual(providedMessage, receivedMessage) { // If simple data type is passed, e.g. String or ArrayBuffer, convert it // to NDEFMessage before comparing. // https://w3c.github.io/web-nfc/#dom-ndefmessagesource let provided = providedMessage; if (providedMessage instanceof ArrayBuffer) provided = createMessage([createOpaqueRecord(providedMessage)]); else if (typeof providedMessage === 'string') provided = createMessage([createTextRecord(providedMessage)]); assert_equals(provided.records.length, receivedMessage.data.length, 'NDEFMessages must have same number of NDEFRecords'); // Compare contents of each individual NDEFRecord for (let i = 0; i < provided.records.length; ++i) compareNDEFRecords(provided.records[i], receivedMessage.data[i]); } // Used to compare two NDEFMessage, one that is received from // NFCWriter.onreading() EventHandler and another that is provided to mock NFC // service. function assertWebNDEFMessagesEqual(message, expectedMessage) { if (expectedMessage.url) assert_equals(message.url, expectedMessage.url); assert_equals(message.records.length, expectedMessage.records.length); for(let i in message.records) { let record = message.records[i]; let expectedRecord = expectedMessage.records[i]; assert_equals(record.recordType, expectedRecord.recordType); assert_equals(record.mediaType, expectedRecord.mediaType); // Compares record data assert_equals(record.toText(), expectedRecord.toText()); assert_array_equals(new Uint8Array(record.toArrayBuffer()), new Uint8Array(expectedRecord.toArrayBuffer())); let json; try { json = record.toJSON(); } catch (e) { } let expectedJson; try { expectedJson = expectedRecord.toJSON(); } catch (e) { } if (json === undefined) assert_equals(expectedJson, undefined); else assert_object_equals(json, expectedJson); } } function testNFCReaderOptions(message, readOptions, unmatchedReadOptions, desc) { nfc_test(async (t, mockNFC) => { const reader1 = new NFCReader(unmatchedReadOptions); const reader2 = new NFCReader(readOptions); mockNFC.setReadingMessage(message, readOptions.compatibility); // Reading from unmatched reader will not be triggered reader1.onreading = t.unreached_func("reading event should not be fired."); reader1.start(); const readerWatcher = new EventWatcher(t, reader2, ["reading", "error"]); const promise = readerWatcher.wait_for("reading").then(event => { reader1.stop(); reader2.stop(); assertWebNDEFMessagesEqual(event.message, new NDEFMessage(message)); }); // NFCReader#start() asynchronously dispatches the onreading event. reader2.start(); await promise; }, desc); } function testReadingMultiMessages(message, readOptions, unmatchedMessage, unmatchedCompatibility, desc) { nfc_test(async (t, mockNFC) => { const reader = new NFCReader(readOptions); const readerWatcher = new EventWatcher(t, reader, ["reading", "error"]); const promise = readerWatcher.wait_for("reading").then(event => { reader.stop(); assertWebNDEFMessagesEqual(event.message, new NDEFMessage(message)); }); // NFCReader#start() asynchronously dispatches the onreading event. reader.start(); // Unmatched message will not be read mockNFC.setReadingMessage(unmatchedMessage, unmatchedCompatibility); mockNFC.setReadingMessage(message); await promise; }, desc); }