@rtcstats/rtcstats-js 2.4.0 → 2.5.0

package/README.md

@@ -48,6 +48,7 @@ The main rtcstats.js exports a number of methods that facilitate this:
   object and generates traces using the supplied `trace` method.
 * `wrapGetUserMedia` and `wrapEnumerateDevices` do the same for the `getUserMedia`/`getDisplayMedia`,
   `enumerateDevices` and related APIs such as MediaStreamTracks and HTMLVideoElement.
+* `wrapSetSinkId` does the same for HTMLMediaElement's `setSinkId` method which changes the audio output device.
 
 Typical usage looks like this:
 ```

package/media.js

@@ -132,3 +132,30 @@ export function wrapEnumerateDevices(trace, {navigator}) {
     }
 }
 
+/**
+ * Wraps HTMLMediaElement.setSinkId for RTCStats.
+ *
+ * @param {function} trace - RTCStats trace callback.
+ * @param {object} window - window object with HTMLMediaElement.
+ */
+export function wrapSetSinkId(trace, {HTMLMediaElement}) {
+    if (!(HTMLMediaElement && HTMLMediaElement.prototype.setSinkId)) {
+        return;
+    }
+    if (HTMLMediaElement.prototype.setSinkId.__rtcStats) {
+        // Prevent double-wrapping.
+        return;
+    }
+    const origMethod = HTMLMediaElement.prototype.setSinkId;
+    const wrappedMethod = function(...args) {
+        trace('HTMLMediaElement.setSinkId', null, args[0]);
+        return origMethod.apply(this, args)
+            .then((result) => result, (err) => {
+                trace('HTMLMediaElement.setSinkIdOnFailure', null, err.toString(), args[0]);
+                return Promise.reject(err);
+            });
+    };
+    wrappedMethod.__rtcStats = true;
+    HTMLMediaElement.prototype.setSinkId = wrappedMethod;
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtcstats/rtcstats-js",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "gather WebRTC API traces and statistics",
   "main": "rtcstats.js",
   "type": "module",

package/rtcstats.js

@@ -1,5 +1,5 @@
 import {wrapRTCPeerConnection} from './peerconnection.js';
-import {wrapGetUserMedia, wrapEnumerateDevices} from './media.js';
+import {wrapGetUserMedia, wrapEnumerateDevices, wrapSetSinkId} from './media.js';
 import {WebSocketTrace} from './trace-websocket.js';
 
 /**
@@ -16,6 +16,8 @@ export function wrapRTCStatsWithDefaultOptions(config = {getStatsInterval: 1000}
     wrapGetUserMedia(trace, target);
     // Wrap enumerateDevices.
     wrapEnumerateDevices(trace, target);
+    // Wrap HTMLMediaElement.setSinkId.
+    wrapSetSinkId(trace, target);
 
     return trace;
 }
@@ -24,5 +26,6 @@ export {
     wrapRTCPeerConnection,
     wrapGetUserMedia,
     wrapEnumerateDevices,
+    wrapSetSinkId,
     WebSocketTrace,
 };