@thumbmarkjs/thumbmarkjs 1.7.6 → 1.8.0

package/src/components/mediaDevices/index.test.ts

@@ -0,0 +1,120 @@
+import getMediaDevices from './index';
+
+describe('mediaDevices component tests', () => {
+  let originalMediaDevices: MediaDevices | undefined;
+
+  beforeAll(() => {
+    originalMediaDevices = navigator.mediaDevices;
+  });
+
+  afterAll(() => {
+    Object.defineProperty(navigator, 'mediaDevices', {
+      value: originalMediaDevices,
+      configurable: true,
+    });
+  });
+
+  function mockEnumerateDevices(devices: Array<{ kind: string }>) {
+    Object.defineProperty(navigator, 'mediaDevices', {
+      value: {
+        enumerateDevices: jest.fn().mockResolvedValue(devices),
+      },
+      configurable: true,
+    });
+  }
+
+  test('returns valid structure when API is available', async () => {
+    mockEnumerateDevices([
+      { kind: 'audioinput' },
+      { kind: 'audiooutput' },
+      { kind: 'videoinput' },
+    ]);
+
+    const result = await getMediaDevices();
+
+    expect(result).toEqual({
+      audioinput: 1,
+      audiooutput: 1,
+      videoinput: 1,
+    });
+  });
+
+  test('returns null when mediaDevices API is unavailable', async () => {
+    Object.defineProperty(navigator, 'mediaDevices', {
+      value: undefined,
+      configurable: true,
+    });
+
+    const result = await getMediaDevices();
+    expect(result).toBeNull();
+  });
+
+  test('returns null when enumerateDevices throws', async () => {
+    Object.defineProperty(navigator, 'mediaDevices', {
+      value: {
+        enumerateDevices: jest.fn().mockRejectedValue(new Error('NotAllowedError')),
+      },
+      configurable: true,
+    });
+
+    const result = await getMediaDevices();
+    expect(result).toBeNull();
+  });
+
+  test('handles empty device list', async () => {
+    mockEnumerateDevices([]);
+
+    const result = await getMediaDevices();
+
+    expect(result).toEqual({
+      audioinput: 0,
+      audiooutput: 0,
+      videoinput: 0,
+    });
+  });
+
+  test('counts multiple devices of same kind', async () => {
+    mockEnumerateDevices([
+      { kind: 'videoinput' },
+      { kind: 'videoinput' },
+      { kind: 'audioinput' },
+    ]);
+
+    const result = await getMediaDevices();
+
+    expect(result).toEqual({
+      audioinput: 1,
+      audiooutput: 0,
+      videoinput: 2,
+    });
+  });
+
+  test('ignores unknown device kind values', async () => {
+    mockEnumerateDevices([
+      { kind: 'audioinput' },
+      { kind: '' },
+      { kind: 'somethingelse' },
+      { kind: 'videoinput' },
+    ]);
+
+    const result = await getMediaDevices();
+
+    expect(result).toEqual({
+      audioinput: 1,
+      audiooutput: 0,
+      videoinput: 1,
+    });
+  });
+
+  test('returns null when enumerateDevices resolves with null', async () => {
+    Object.defineProperty(navigator, 'mediaDevices', {
+      value: {
+        enumerateDevices: jest.fn().mockResolvedValue(null),
+      },
+      configurable: true,
+    });
+
+    const result = await getMediaDevices();
+    expect(result).toBeNull();
+  });
+});

package/src/components/mediaDevices/index.ts

@@ -0,0 +1,26 @@
+import { componentInterface } from '../../factory';
+
+export default async function getMediaDevices(): Promise<componentInterface | null> {
+  if (typeof navigator === 'undefined' ||
+    !navigator.mediaDevices ||
+    typeof navigator.mediaDevices.enumerateDevices !== 'function') {
+    return null;
+  }
+
+  try {
+    const devices = await navigator.mediaDevices.enumerateDevices();
+
+    const counts: Record<string, number> = {};
+    for (const device of devices) {
+      counts[device.kind] = (counts[device.kind] || 0) + 1;
+    }
+
+    return {
+      audioinput: counts['audioinput'] || 0,
+      audiooutput: counts['audiooutput'] || 0,
+      videoinput: counts['videoinput'] || 0,
+    };
+  } catch {
+    return null;
+  }
+}

package/src/factory.ts

@@ -21,6 +21,8 @@ import getSystem from "./components/system";
 import getWebGL from "./components/webgl";
 
 // Import experimental component functions
+import getIntl from "./components/intl";
+import getMediaDevices from "./components/mediaDevices";
 import getWebRTC from "./components/webrtc";
 import getMathML from "./components/mathml";
 import getSpeech from "./components/speech";
@@ -48,7 +50,9 @@ export const tm_component_promises = {
  * @description key->function map of experimental components. Only resolved during logging.
  */
 export const tm_experimental_component_promises = {
+    'intl': getIntl,
     'mathml': getMathML,
+    'mediadevices': getMediaDevices,
 };
 
 // the component interface is the form of the JSON object the function's promise must return