Add experimental preferCurrentTab screen share capture option (#1070)

* Add experimental preferCurrentTab screen share capture option

* Create rich-worms-leave.md

.changeset/rich-worms-leave.md

@@ -0,0 +1,5 @@
+---
+"livekit-client": patch
+---
+
+Add experimental preferCurrentTab screen share capture option

src/room/track/options.ts

@@ -190,6 +190,13 @@ export interface ScreenShareCaptureOptions {
    * local speakers when the tab is captured.
    */
   suppressLocalAudioPlayback?: boolean;
+
+  /**
+   * Experimental option to instruct the browser to offer the current tab as the most prominent capture source
+   * @experimental
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia#prefercurrenttab
+   */
+  preferCurrentTab?: boolean;
 }
 
 export interface AudioCaptureOptions {

src/room/track/utils.ts

@@ -183,6 +183,7 @@ export function screenCaptureToDisplayMediaStreamOptions(
     selfBrowserSurface: options.selfBrowserSurface,
     surfaceSwitching: options.surfaceSwitching,
     systemAudio: options.systemAudio,
+    preferCurrentTab: options.preferCurrentTab,
   };
 }