We introduce a dictionary member to MediaStreamConstraints called preferCurrentTab. It's a boolean defaulting to false. When getDisplayMedia() is called with preferCurrentTab=true, the browser should offer the current tab as the most prominent capture source.

Motivation

Sometimes a page wishes to capture itself. For example, a slide-deck might wish to capture itself and stream itself to a conference call, or a user might wish to capture footage of themselves playing an online game.

Specification

Editor's draft

Status in Chromium

Blink


Origin trial (tracking bug) in:

  • Chrome for desktop release 90

Consensus & Standardization

After a feature ships in Chrome, the values listed here are not guaranteed to be up to date.

  • Harmful
  • No signal
  • No signal
  • Strongly positive

Owners

Intent to Prototype url

Intent to Prototype thread

Search tags

getDisplayMedia, capture, getCurrentBrowsingContextMedia, share, sharing,

Last updated on 2021-07-22