mediasoup-client 3.15.7 → 3.16.0

package/lib/Device.d.ts

@@ -18,15 +18,16 @@ export type DeviceOptions = {
 /**
  * Sync mediasoup-client Handler detection.
  */
-export declare function detectDevice(userAgent?: string): BuiltinHandlerName | undefined;
+export declare function detectDevice(userAgent?: string, userAgentData?: NavigatorUAData): BuiltinHandlerName | undefined;
 /**
  * Async mediasoup-client Handler detection.
  *
  * @remarks
  * - Currently it runs same logic than `detectDevice()`.
- * - In the future this function could give better results than `detectDevice()`.
+ * - In the future this function could give better results than
+ *   `detectDevice()`.
  */
-export declare function detectDeviceAsync(userAgent?: string): Promise<BuiltinHandlerName | undefined>;
+export declare function detectDeviceAsync(userAgent?: string, userAgentData?: NavigatorUAData): Promise<BuiltinHandlerName | undefined>;
 export type DeviceObserver = EnhancedEventEmitter<DeviceObserverEvents>;
 export type DeviceObserverEvents = {
     newtransport: [Transport];

package/lib/Device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Device.d.ts","sourceRoot":"","sources":["../src/Device.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Device.d.ts","sourceRoot":"","sources":["../src/Device.ts"],"names":[],"mappings":"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"}

package/lib/Device.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Device = void 0;
 exports.detectDevice = detectDevice;
 exports.detectDeviceAsync = detectDeviceAsync;
-const browser_dtector_1 = require("browser-dtector");
 const Logger_1 = require("./Logger");
 const enhancedEvents_1 = require("./enhancedEvents");
 const errors_1 = require("./errors");
@@ -19,28 +18,33 @@ const logger = new Logger_1.Logger('Device');
 /**
  * Sync mediasoup-client Handler detection.
  */
-function detectDevice(userAgent) {
-    logger.debug('detectDevice() [userAgent:%s]', userAgent);
+function detectDevice(userAgent, userAgentData) {
+    logger.debug('detectDevice()');
     if (!userAgent && typeof navigator === 'object') {
         userAgent = navigator.userAgent;
     }
-    const browserDetector = new browser_dtector_1.default(userAgent);
-    return detectDeviceImpl(browserDetector);
+    if (!userAgentData && typeof navigator === 'object') {
+        userAgentData = navigator.userAgentData;
+    }
+    return detectDeviceImpl(userAgent, userAgentData);
 }
 /**
  * Async mediasoup-client Handler detection.
  *
  * @remarks
  * - Currently it runs same logic than `detectDevice()`.
- * - In the future this function could give better results than `detectDevice()`.
+ * - In the future this function could give better results than
+ *   `detectDevice()`.
  */
-async function detectDeviceAsync(userAgent) {
-    logger.debug('detectDeviceAsync() [userAgent:%s]', userAgent);
+async function detectDeviceAsync(userAgent, userAgentData) {
+    logger.debug('detectDeviceAsync()');
     if (!userAgent && typeof navigator === 'object') {
         userAgent = navigator.userAgent;
     }
-    const browserDetector = new browser_dtector_1.default(userAgent);
-    return detectDeviceImpl(browserDetector);
+    if (!userAgentData && typeof navigator === 'object') {
+        userAgentData = navigator.userAgentData;
+    }
+    return detectDeviceImpl(userAgent, userAgentData);
 }
 class Device {
     // RTC handler factory.
@@ -313,89 +317,188 @@ class Device {
     }
 }
 exports.Device = Device;
-function detectDeviceImpl(browserDetector) {
-    // React-Native.
-    if (typeof navigator === 'object' && navigator.product === 'ReactNative') {
-        logger.debug('detectDeviceImpl() | React-Native detected');
-        if (typeof RTCPeerConnection === 'undefined' ||
-            typeof RTCRtpTransceiver === 'undefined') {
-            logger.warn('detectDeviceImpl() | unsupported react-native-webrtc without RTCPeerConnection or RTCRtpTransceiver, forgot to call registerGlobals() on it?');
-            return undefined;
-        }
-        return 'ReactNative106';
-    }
-    // Browser.
-    else {
-        const parsed = browserDetector.parseUserAgent();
-        const browserMajorVersionMatch = /^\d+/.exec(parsed?.shortVersion ?? '0');
-        const browserMajorVersion = parseInt(browserMajorVersionMatch?.[0] ?? '0', 10);
-        const isIOS = parsed.platform === browser_dtector_1.KnownPlatforms.iphone ||
-            parsed.platform === browser_dtector_1.KnownPlatforms.ipad ||
-            (parsed.platform === browser_dtector_1.KnownPlatforms.mac &&
-                (parsed.isMobile ||
-                    parsed.isTablet ||
-                    (typeof navigator === 'object' && navigator?.maxTouchPoints >= 2)));
-        const isChrome = parsed.isChrome;
-        const isFirefox = parsed.isFireFox;
-        const isSafari = parsed.isSafari;
-        const isEdge = parsed.isEdge;
-        const isElectron = parsed.isDesktop && parsed.name === browser_dtector_1.KnownBrowsers.electron;
-        // For logging purposes.
-        const result = {
-            browserMajorVersion,
-            isIOS,
-            isChrome,
-            isFirefox,
-            isSafari,
-            isElectron,
-        };
-        logger.debug('detectDeviceImpl() | detected browser [userAgent:%s, parsed:%o, result:%o]', parsed.userAgent, parsed, result);
-        // Chrome, Chromium, and Edge.
-        if ((isChrome || isEdge) && !isIOS && browserMajorVersion >= 111) {
+function detectDeviceImpl(userAgent, userAgentData) {
+    logger.debug('detectDeviceImpl() [userAgent:"%s", userAgentData:%o]', userAgent, userAgentData);
+    const chromiumMajorVersion = getChromiumMajorVersion(userAgent, userAgentData);
+    if (chromiumMajorVersion) {
+        if (chromiumMajorVersion >= 111) {
+            logger.debug('detectDeviceImpl() | using Chrome111 handler');
             return 'Chrome111';
         }
-        else if ((isChrome && !isIOS && browserMajorVersion >= 74) ||
-            (isEdge && !isIOS && browserMajorVersion >= 88)) {
+        else if (chromiumMajorVersion >= 74) {
+            logger.debug('detectDeviceImpl() | using Chrome74 handler');
             return 'Chrome74';
         }
-        // Electron.
-        else if (isElectron) {
-            return 'Chrome111';
+        else {
+            logger.warn('detectDeviceImpl() | unsupported Chromium based browser/version');
+            return undefined;
         }
-        // Firefox.
-        else if (isFirefox && !isIOS && browserMajorVersion >= 120) {
+    }
+    const firefoxMajorVersion = getFirefoxMajorVersion(userAgent);
+    if (firefoxMajorVersion) {
+        if (firefoxMajorVersion >= 120) {
+            logger.debug('detectDeviceImpl() | using Firefox120 handler');
             return 'Firefox120';
         }
-        // Safari.
-        else if (isSafari &&
-            browserMajorVersion >= 12 &&
-            typeof RTCRtpTransceiver !== 'undefined' &&
-            RTCRtpTransceiver.prototype.hasOwnProperty('currentDirection')) {
+        else {
+            logger.warn('detectDeviceImpl() | unsupported Firefox browser/version');
+            return undefined;
+        }
+    }
+    const macOSWebKitMajorVersion = getMacOSWebKitMajorVersion(userAgent);
+    if (macOSWebKitMajorVersion) {
+        if (macOSWebKitMajorVersion >= 605) {
+            logger.debug('detectDeviceImpl() | using Safari12 handler');
             return 'Safari12';
         }
-        // Best effort for WebKit based browsers in iOS.
-        else if (isIOS &&
-            typeof RTCRtpTransceiver !== 'undefined' &&
-            RTCRtpTransceiver.prototype.hasOwnProperty('currentDirection')) {
+        else {
+            logger.warn('detectDeviceImpl() | unsupported desktop Safari browser/version');
+            return undefined;
+        }
+    }
+    const iOSWebKitMajorVersion = getIOSWebKitMajorVersion(userAgent);
+    if (iOSWebKitMajorVersion) {
+        if (iOSWebKitMajorVersion >= 605) {
+            logger.debug('detectDeviceImpl() | using Safari12 handler');
             return 'Safari12';
         }
-        // Best effort for Chromium based browsers.
         else {
-            const match = browserDetector.userAgent?.match(/(?:(?:Chrome|Chromium))[ /](\w+)/i);
-            if (match) {
-                const version = Number(match[1]);
-                if (version >= 111) {
-                    return 'Chrome111';
-                }
-                else {
-                    return 'Chrome74';
-                }
-            }
-            // Unsupported browser.
-            else {
-                logger.warn('detectDeviceImpl() | browser not supported [userAgent:%s, parsed:%o, result:%o]', parsed.userAgent, parsed, result);
-                return undefined;
-            }
+            logger.warn('detectDeviceImpl() | unsupported iOS Safari based browser/version');
+            return undefined;
         }
     }
+    if (isReactNative()) {
+        if (typeof RTCPeerConnection !== 'undefined' &&
+            typeof RTCRtpTransceiver !== 'undefined') {
+            logger.debug('detectDeviceImpl() | using ReactNative106 handler');
+            return 'ReactNative106';
+        }
+        else {
+            logger.warn('detectDeviceImpl() | unsupported react-native-webrtc version without RTCPeerConnection or RTCRtpTransceiver, forgot to call registerGlobals() on it?');
+            return undefined;
+        }
+    }
+    logger.warn('detectDeviceImpl() | device not supported [userAgent:"%s", userAgentData:%o]', userAgent, userAgentData);
+    return undefined;
+}
+function getChromiumMajorVersion(userAgent, userAgentData) {
+    if (isIOS(userAgent, userAgentData)) {
+        logger.debug('getChromiumMajorVersion() | this is iOS => undefined');
+        return undefined;
+    }
+    if (isReactNative()) {
+        logger.debug('getChromiumMajorVersion() | this is React-Native => undefined');
+        return undefined;
+    }
+    if (userAgentData) {
+        const chromiumBrand = userAgentData.brands.find(b => b.brand === 'Chromium');
+        if (chromiumBrand) {
+            const majorVersion = Number(chromiumBrand.version);
+            logger.debug(`getChromiumMajorVersion() | Chromium major version based on NavigatorUAData => ${majorVersion}`);
+            return majorVersion;
+        }
+    }
+    const match = userAgent?.match(/\b(?:Chrome|Chromium)\/(\w+)/i);
+    if (match?.[1]) {
+        const majorVersion = Number(match[1]);
+        logger.debug(`getChromiumMajorVersion() | Chromium major version based on User-Agent => ${majorVersion}`);
+        return majorVersion;
+    }
+    logger.debug('getChromiumMajorVersion() | this is not Chromium => undefined');
+    return undefined;
+}
+function getFirefoxMajorVersion(userAgent) {
+    if (isIOS(userAgent)) {
+        logger.debug('getFirefoxMajorVersion() | this is iOS => undefined');
+        return undefined;
+    }
+    if (isReactNative()) {
+        logger.debug('getFirefoxMajorVersion() | this is React-Native => undefined');
+        return undefined;
+    }
+    const match = userAgent?.match(/\bFirefox\/(\w+)/i);
+    if (match?.[1]) {
+        const majorVersion = Number(match[1]);
+        logger.debug(`getFirefoxMajorVersion() | Firefox major version based on User-Agent => ${majorVersion}`);
+        return majorVersion;
+    }
+    logger.debug('getFirefoxMajorVersion() | this is not Firefox => undefined');
+    return undefined;
+}
+function getMacOSWebKitMajorVersion(userAgent) {
+    if (isIOS(userAgent)) {
+        logger.debug('getMacOSWebKitMajorVersion() | this is iOS => undefined');
+        return undefined;
+    }
+    if (isReactNative()) {
+        logger.debug('getMacOSWebKitMajorVersion() | this is React-Native => undefined');
+        return undefined;
+    }
+    const isSafari = userAgent &&
+        /\bSafari\b/i.test(userAgent) &&
+        !/\bChrome\b/i.test(userAgent) &&
+        !/\bChromium\b/i.test(userAgent) &&
+        !/\bFirefox\b/i.test(userAgent);
+    if (!isSafari) {
+        logger.debug('getMacOSWebKitMajorVersion() | this is not Safari => undefined');
+        return undefined;
+    }
+    const match = userAgent.match(/AppleWebKit\/(\w+)/i);
+    if (match?.[1]) {
+        const majorVersion = Number(match[1]);
+        logger.debug(`getMacOSWebKitMajorVersion() | WebKit major version based on User-Agent => ${majorVersion}`);
+        return majorVersion;
+    }
+    logger.debug('getMacOSWebKitMajorVersion() | this is not WebKit => undefined');
+    return undefined;
+}
+function getIOSWebKitMajorVersion(userAgent) {
+    if (!isIOS(userAgent)) {
+        logger.debug('getIOSWebKitMajorVersion() | this is not iOS => undefined');
+        return undefined;
+    }
+    if (isReactNative()) {
+        logger.debug('getIOSWebKitMajorVersion() | this is React-Native => undefined');
+        return undefined;
+    }
+    const match = userAgent?.match(/AppleWebKit\/(\w+)/i);
+    if (match?.[1]) {
+        const majorVersion = Number(match[1]);
+        logger.debug(`getIOSWebKitMajorVersion() | WebKit major version based on User-Agent => ${majorVersion}`);
+        return majorVersion;
+    }
+    logger.debug('getIOSWebKitMajorVersion() | this is not WebKit => undefined');
+    return undefined;
+}
+function isIOS(userAgent, userAgentData) {
+    if (userAgentData?.platform === 'iOS') {
+        logger.debug('isIOS() | this is iOS based on NavigatorUAData.platform => true');
+        return true;
+    }
+    if (userAgentData?.platform) {
+        logger.debug('isIOS() | this is not iOS based on NavigatorUAData.platform => false');
+        return false;
+    }
+    if (userAgent && /iPad|iPhone|iPod/.test(userAgent)) {
+        logger.debug('isIOS() | this is iOS based on User-Agent => true');
+        return true;
+    }
+    // iPadOS 13+ identifies itself as Mac (to force desktop view mode in some
+    // websites) but we know it's iOS if it has touch screen.
+    if (typeof navigator === 'object' &&
+        navigator.platform === 'MacIntel' &&
+        navigator.maxTouchPoints > 1) {
+        logger.debug('isIOS() | this is iPadOS 13+ based on User-Agent => true');
+        return true;
+    }
+    logger.debug('isIOS() | this is not iOS => false');
+    return false;
+}
+function isReactNative() {
+    if (typeof navigator === 'object' && navigator.product === 'ReactNative') {
+        logger.debug('isReactNative() | this is React-Native based on navigator.product');
+        return true;
+    }
+    logger.debug('isReactNative() | this is not React-Native => false');
+    return false;
 }

package/lib/index.d.ts

@@ -6,7 +6,7 @@ export * as types from './types';
 /**
  * Expose mediasoup-client version.
  */
-export declare const version = "3.15.7";
+export declare const version = "3.16.0";
 /**
  * Expose Device class and device detector helpers.
  */

package/lib/index.js

@@ -10,7 +10,7 @@ exports.types = require("./types");
 /**
  * Expose mediasoup-client version.
  */
-exports.version = '3.15.7';
+exports.version = '3.16.0';
 /**
  * Expose Device class and device detector helpers.
  */

package/lib/test/test.js

@@ -1166,8 +1166,8 @@ describe('detectDevice() and detectDeviceAsync() assign proper handler based on
                     stop() { }
                 };
             }
-            expect(detectDevice(uaTestCase.ua)).toBe(uaTestCase.expect);
-            await expect(detectDeviceAsync(uaTestCase.ua)).resolves.toBe(uaTestCase.expect);
+            expect(detectDevice(uaTestCase.userAgent, uaTestCase.userAgentData)).toBe(uaTestCase.expect);
+            await expect(detectDeviceAsync(uaTestCase.userAgent, uaTestCase.userAgentData)).resolves.toBe(uaTestCase.expect);
             // Cleanup.
             global.RTCRtpTransceiver = originalRTCRtpTransceiver;
         }, 100);

package/lib/test/uaTestCases.d.ts

@@ -1,7 +1,8 @@
 import type { BuiltinHandlerName } from '../Device';
 type UATestCase = {
     desc: string;
-    ua: string;
+    userAgent: string;
+    userAgentData?: NavigatorUAData;
     expect?: BuiltinHandlerName;
 };
 export declare const uaTestCases: UATestCase[];

package/lib/test/uaTestCases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uaTestCases.d.ts","sourceRoot":"","sources":["../../src/test/uaTestCases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,KAAK,UAAU,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAAU,EAuFnC,CAAC"}
+{"version":3,"file":"uaTestCases.d.ts","sourceRoot":"","sources":["../../src/test/uaTestCases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,KAAK,UAAU,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAAU,EAkNnC,CAAC"}

package/lib/test/uaTestCases.js

@@ -2,90 +2,192 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.uaTestCases = void 0;
 exports.uaTestCases = [
+    {
+        desc: 'Chrome 140 (MacOS)',
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36',
+        userAgentData: {
+            brands: [
+                {
+                    brand: 'Chromium',
+                    version: '140',
+                },
+                {
+                    brand: 'Not=A?Brand',
+                    version: '24',
+                },
+                {
+                    brand: 'Google Chrome',
+                    version: '140',
+                },
+            ],
+            mobile: false,
+            platform: 'macOS',
+        },
+        expect: 'Chrome111',
+    },
+    {
+        desc: 'Chrome Canary 142 (MacOS)',
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36',
+        userAgentData: {
+            brands: [
+                {
+                    brand: 'Chromium',
+                    version: '142',
+                },
+                {
+                    brand: 'Google Chrome',
+                    version: '142',
+                },
+                {
+                    brand: 'Not_A Brand',
+                    version: '99',
+                },
+            ],
+            mobile: false,
+            platform: 'macOS',
+        },
+        expect: 'Chrome111',
+    },
+    {
+        desc: 'Microsoft Edge 140 (MacOS)',
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36 Edg/140.0.0.0',
+        userAgentData: {
+            brands: [
+                {
+                    brand: 'Chromium',
+                    version: '140',
+                },
+                {
+                    brand: 'Not=A?Brand',
+                    version: '24',
+                },
+                {
+                    brand: 'Microsoft Edge',
+                    version: '140',
+                },
+            ],
+            mobile: false,
+            platform: 'macOS',
+        },
+        expect: 'Chrome111',
+    },
+    {
+        desc: 'Opera 122 (MacOS)',
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36 OPR/122.0.0.0',
+        userAgentData: {
+            brands: [
+                {
+                    brand: 'Not)A;Brand',
+                    version: '8',
+                },
+                {
+                    brand: 'Chromium',
+                    version: '138',
+                },
+                {
+                    brand: 'Opera',
+                    version: '122',
+                },
+            ],
+            mobile: false,
+            platform: 'macOS',
+        },
+        expect: 'Chrome111',
+    },
+    {
+        desc: 'Firefox 142 (on MacOS)',
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:142.0) Gecko/20100101 Firefox/142.0',
+        expect: 'Firefox120',
+    },
+    {
+        desc: 'Safari 18 (on MacOS)',
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.6 Safari/605.1.15',
+        expect: 'Safari12',
+    },
     {
         desc: 'Microsoft Edge 100',
-        ua: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.1108.55 Safari/537.36 Edg/100.0.1108.55',
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.1108.55 Safari/537.36 Edg/100.0.1108.55',
         expect: 'Chrome74',
     },
     {
         desc: 'Mac (Intel) Chrome 112',
-        ua: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36',
+        userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36',
         expect: 'Chrome111',
     },
     {
         desc: 'iPhone iOS 16',
-        ua: 'Mozilla/5.0 (iPhone; CPU iPhone OS 18_6_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.4 Mobile/15E148 Safari/604.1',
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 18_6_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.4 Mobile/15E148 Safari/604.1',
         expect: 'Safari12',
     },
     {
         desc: 'Generic Android Chrome 112',
-        ua: 'Mozilla/5.0 (Linux; Android 13; M2012K11AG) AppleWebKit/537.36 (KHTML, like Gecko) Soul/4.0 Chrome/112.0.5615.135 Mobile Safari/537.36',
+        userAgent: 'Mozilla/5.0 (Linux; Android 13; M2012K11AG) AppleWebKit/537.36 (KHTML, like Gecko) Soul/4.0 Chrome/112.0.5615.135 Mobile Safari/537.36',
         expect: 'Chrome111',
     },
     {
         desc: 'Motorola Edge Chrome 104',
-        ua: 'Mozilla/5.0 (Linux; Android 10; motorola edge) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.0.0 Mobile Safari/537.36',
+        userAgent: 'Mozilla/5.0 (Linux; Android 10; motorola edge) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.0.0 Mobile Safari/537.36',
         expect: 'Chrome74',
     },
     {
         desc: 'In-app WebView (Android)',
-        ua: 'Mozilla/5.0 (Linux; Android 11; G91 Pro Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/114.0.5735.130 Mobile Safari/537.36',
+        userAgent: 'Mozilla/5.0 (Linux; Android 11; G91 Pro Build/RP1A.200720.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/114.0.5735.130 Mobile Safari/537.36',
         expect: 'Chrome111',
     },
     {
         desc: 'Brave',
-        ua: 'Mozilla/5.0 (Windows NT 10.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/113.0.4044.113 Safari/5370.36 Brave/9085',
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/113.0.4044.113 Safari/5370.36 Brave/9085',
         expect: 'Chrome111',
     },
     {
         desc: 'In-app WebView (Android) (Facebook)',
-        ua: 'Mozilla/5.0 (Linux; Android 12; SM-S908U1 Build/SP1A.210812.016; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/100.0.4896.88 Mobile Safari/537.36 [FB_IAB/FB4A;FBAV/377.0.0.22.107;]',
+        userAgent: 'Mozilla/5.0 (Linux; Android 12; SM-S908U1 Build/SP1A.210812.016; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/100.0.4896.88 Mobile Safari/537.36 [FB_IAB/FB4A;FBAV/377.0.0.22.107;]',
         expect: 'Chrome74',
     },
     {
         desc: 'Firefox (iOS)',
-        ua: 'Mozilla/5.0 (iPhone; CPU iPhone OS 18_6_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) FxiOS/142.0.1 Mobile/15E148 Safari/605.1.15',
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 18_6_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) FxiOS/142.0.1 Mobile/15E148 Safari/605.1.15',
         expect: 'Safari12',
     },
     {
         desc: 'In-app WKWebView (iOS) (TikTok)',
-        ua: 'Mozilla/5.0 (iPhone; CPU iPhone OS 14_8 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 musical_ly_21.1.0 JsSdk/2.0 NetType/4G Channel/App Store ByteLocale/ru Region/RU ByteFullLocale/ru-RU isDarkMode/1 WKWebView/1 BytedanceWebview/d8a21c6',
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 14_8 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 musical_ly_21.1.0 JsSdk/2.0 NetType/4G Channel/App Store ByteLocale/ru Region/RU ByteFullLocale/ru-RU isDarkMode/1 WKWebView/1 BytedanceWebview/d8a21c6',
         expect: 'Safari12',
     },
     {
         desc: 'In-app WkWebView (iOS) (WeChat)',
-        ua: 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MicroMessenger/8.0.37(0x1800252f) NetType/WIFI Language/zh_CN',
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_0_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MicroMessenger/8.0.37(0x1800252f) NetType/WIFI Language/zh_CN',
         expect: 'Safari12',
     },
     {
         desc: 'Custom Webview in iPad',
-        ua: 'Mozilla/5.0 (iPad; CPU iPadOS 16_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Mobile/15E148 Safari/604.1 MyApp/1.0',
+        userAgent: 'Mozilla/5.0 (iPad; CPU iPadOS 16_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Mobile/15E148 Safari/604.1 MyApp/1.0',
         expect: 'Safari12',
     },
     {
         desc: 'Chrome Mobile (iOS)',
-        ua: 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/114.0.5735.124 Mobile/15E148 Safari/604.1',
+        userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 16_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/114.0.5735.124 Mobile/15E148 Safari/604.1',
         expect: 'Safari12',
     },
     {
         desc: 'Fake Foo Invalid Browser - Unsupported',
-        ua: 'Fake/5.0 (Foo; Bar Lalala OS_19.5) Foo/22.2',
+        userAgent: 'Fake/5.0 (Foo; Bar Lalala OS_19.5) Foo/22.2',
         expect: undefined,
     },
     {
         // Zoom App Marketplace browser.
         desc: 'Zoom App Marketplace browser - Unsupported',
-        ua: 'Mozilla/5.0 ZoomWebKit/537.36 (KHTML, like Gecko) ZoomApps/1.0',
+        userAgent: 'Mozilla/5.0 ZoomWebKit/537.36 (KHTML, like Gecko) ZoomApps/1.0',
         expect: undefined,
     },
     {
         desc: 'Electron in Windows',
-        ua: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Electron/37.4.0 Chrome/138.0.7204.243 Safari/537.36',
+        userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Electron/37.4.0 Chrome/138.0.7204.243 Safari/537.36',
         expect: 'Chrome111',
     },
     {
         desc: 'Samsung Browser (Android)',
-        ua: 'Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/28.0 Chrome/130.0.0.0 Mobile Safari/537.36',
+        userAgent: 'Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/28.0 Chrome/130.0.0.0 Mobile Safari/537.36',
         expect: 'Chrome111',
     },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mediasoup-client",
-	"version": "3.15.7",
+	"version": "3.16.0",
 	"description": "mediasoup client side TypeScript library",
 	"contributors": [
 		"Iñaki Baz Castillo <ibc@aliax.net> (https://inakibaz.me)",
@@ -74,7 +74,6 @@
 		"@types/debug": "^4.1.12",
 		"@types/events-alias": "npm:@types/events@^3.0.3",
 		"awaitqueue": "^3.2.4",
-		"browser-dtector": "^4.1.0",
 		"debug": "^4.4.3",
 		"events-alias": "npm:events@^3.3.0",
 		"fake-mediastreamtrack": "^2.1.4",