Unit tests for library

.gitignore

@@ -6,4 +6,5 @@ node_modules/
 node.zip
 SignallingWebServer/Public/
 SignallingWebServer/certificates
-.vscode
+.vscode
+coverage/

Frontend/library/jest.config.js

@@ -0,0 +1,18 @@
+module.exports = {
+  preset: "ts-jest/presets/js-with-ts",
+  testEnvironment: "jsdom",
+  transform: {
+    "^.+\\.tsx?$": [
+      "ts-jest",
+      {
+        tsconfig: "tsconfig.jest.json",
+      },
+    ],
+  },
+  modulePathIgnorePatterns: ["<rootDir>/build/"],
+  testPathIgnorePatterns: ["<rootDir>/build/", "/node_modules/"],
+  globals: {
+    TextDecoder: TextDecoder,
+    TextEncoder: TextEncoder,
+  }
+};

Frontend/library/package.json

@@ -11,15 +11,20 @@
         "build": "npx webpack --config webpack.prod.js",
         "build-dev": "npx webpack --config webpack.dev.js",
         "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+        "test": "jest --detectOpenHandles --coverage=true",
         "spellcheck": "cspell \"{README.md,.github/*.md,src/**/*.ts}\""
     },
     "devDependencies": {
+        "@types/jest": "29.4.0",
+        "@types/webxr": "^0.5.1",
         "@typescript-eslint/eslint-plugin": "^5.16.0",
         "@typescript-eslint/parser": "^5.16.0",
-        "@types/webxr": "^0.5.1",
         "cspell": "^4.1.0",
         "eslint": "^8.11.0",
+        "jest": "^29.4.0",
+        "jest-environment-jsdom": "29.4.0",
         "prettier": "2.8.3",
+        "ts-jest": "29.0.5",
         "ts-loader": "^9.4.2",
         "typedoc": "^0.23.24",
         "typescript": "^4.9.4",

Frontend/library/src/AFK/AFKController.test.ts

@@ -0,0 +1,162 @@
+import { Config, Flags, NumericParameters } from '../Config/Config';
+import { PixelStreaming } from '../PixelStreaming/PixelStreaming';
+import { AfkTimedOutEvent, AfkWarningActivateEvent, AfkWarningUpdateEvent, AfkWarningDeactivateEvent } from '../Util/EventEmitter';
+import { mockRTCRtpReceiver, unmockRTCRtpReceiver } from '../__test__/mockRTCRtpReceiver';
+import {
+    AFKController
+} from './AFKController';
+
+describe('AFKController', () => {
+    let mockPixelStreaming: PixelStreaming;
+
+    beforeEach(() => {
+        mockRTCRtpReceiver();
+        jest.useFakeTimers();
+        mockPixelStreaming = {
+            dispatchEvent: jest.fn()
+        } as any as PixelStreaming; 
+    });
+
+    afterEach(() => {
+        unmockRTCRtpReceiver();
+        jest.resetAllMocks();
+    });
+
+    it('should not activate AFK timer if it has been disabled from settings', () => {
+        const config = new Config({ initialSettings: { [Flags.AFKDetection]: false } });
+        const onDismissAfk = jest.fn();
+        const afkController = new AFKController(config, mockPixelStreaming, onDismissAfk);
+
+        afkController.startAfkWarningTimer();
+        expect(afkController.active).toBe(false);
+
+        jest.advanceTimersByTime(1000000 * 1000);
+        expect(mockPixelStreaming.dispatchEvent).not.toHaveBeenCalled();
+    });
+
+    it('should activate AFK timer and trigger it after specified delay if it has been enabled from settings', () => {
+        const timeoutSeconds = 100;
+
+        const config = new Config({ initialSettings: { [Flags.AFKDetection]: true, [NumericParameters.AFKTimeoutSecs]: timeoutSeconds} });
+        const onDismissAfk = jest.fn();
+        const afkController = new AFKController(config, mockPixelStreaming, onDismissAfk);
+
+        afkController.startAfkWarningTimer();
+        expect(afkController.active).toBe(true);
+
+        // Advance to 1 second before AFK event:
+        jest.advanceTimersByTime((timeoutSeconds - 1) * 1000);
+        expect(mockPixelStreaming.dispatchEvent).not.toHaveBeenCalled();
+
+        // advance 1 more second to trigger AFK warning
+        jest.advanceTimersByTime(1000);
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningActivateEvent({
+            countDown: 0,
+            dismissAfk: expect.anything()
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 10,
+        }));
+
+        // advance 10 more seconds to trigger AFK countdown updates and eventually timeout
+        jest.advanceTimersByTime(10 * 1000);
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 9,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 8,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 7,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 6,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 5,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 4,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 3,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 2,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 1,
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkTimedOutEvent());
+    });
+
+    it('should postpone AFK activation each time resetAfkWarningTimer is called', () => {
+        const timeoutSeconds = 100;
+
+        const config = new Config({ initialSettings: { [Flags.AFKDetection]: true, [NumericParameters.AFKTimeoutSecs]: timeoutSeconds} });
+        const onDismissAfk = jest.fn();
+        const afkController = new AFKController(config, mockPixelStreaming, onDismissAfk);
+
+        afkController.startAfkWarningTimer();
+
+        // Advance to 1 second before AFK event:
+        jest.advanceTimersByTime((timeoutSeconds - 1) * 1000);
+        expect(mockPixelStreaming.dispatchEvent).not.toHaveBeenCalled();
+
+        afkController.resetAfkWarningTimer();
+
+        // advance 1 more second and ensure that AFK warning is not triggered since reset was called
+        jest.advanceTimersByTime(1000);
+        expect(mockPixelStreaming.dispatchEvent).not.toHaveBeenCalled();
+
+        // reset AFK timer once more and ensure it is triggered exactly after timeoutSeconds
+        afkController.resetAfkWarningTimer();
+
+        // Advance to 1 second before AFK event:
+        jest.advanceTimersByTime((timeoutSeconds - 1) * 1000);
+        expect(mockPixelStreaming.dispatchEvent).not.toHaveBeenCalled();
+
+        // advance 1 more second to trigger AFK warning
+        jest.advanceTimersByTime(1000);
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningActivateEvent({
+            countDown: 0,
+            dismissAfk: expect.anything()
+        }));
+    });
+
+    it('should dismiss AFK warning countdown if onAfkClick is called', () => {
+        const timeoutSeconds = 100;
+
+        const config = new Config({ initialSettings: { [Flags.AFKDetection]: true, [NumericParameters.AFKTimeoutSecs]: timeoutSeconds} });
+        const onDismissAfk = jest.fn();
+        const afkController = new AFKController(config, mockPixelStreaming, onDismissAfk);
+
+        afkController.startAfkWarningTimer();
+
+        // Advance to AFK event:
+        jest.advanceTimersByTime(timeoutSeconds * 1000);
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningActivateEvent({
+            countDown: 0,
+            dismissAfk: expect.anything()
+        }));
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 10,
+        }));
+
+        // Advance one more second and call onAfkClick
+        jest.advanceTimersByTime(1000);
+
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningUpdateEvent({
+            countDown: 9,
+        }));
+
+        afkController.onAfkClick();
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledWith(new AfkWarningDeactivateEvent());
+
+        // advance 10 more seconds and ensure there are no more countdown/timeout events emitted
+        jest.advanceTimersByTime(10 * 1000);
+        expect(mockPixelStreaming.dispatchEvent).toHaveBeenCalledTimes(4);
+    });
+
+
+});