Intent to Remove: MediaStreamTrack.getSources()

[Guido Urdaneta]

Primary eng (and PM) emails

eng: gui...@chromium.org, h...@chromium.org

pm: bl...@chromium.org

Link to “Intent to Deprecate” thread

https://groups.google.com/a/chromium.org/forum/#!searchin/blink-dev/getSources%7Csort:relevance/blink-dev/sEr9RBs9Cls/60mH4J4_DwAJ

Summary

The goal is to remove the MediaStreamTrack.getSources() method.

Motivation

This method is no longer part of the spec and is not supported by any other major browser.

Compatibility Risk

The compatibility risk is low. MediaStreamTrack.getSources() is not supported by any other major browser. It has been replaced by MediaDevices.enumerateDevices(), which Blink supports without flags since M47 and which is also supported by other browsers.

Usage information from UseCounter

Use counter graph: https://www.chromestatus.com/metrics/feature/timeline/popularity/478

Since the last three months, usage has decreased to below 0.01%.

OWP launch tracking bug

http://crbug.com/649710

Entry on the feature dashboard

https://www.chromestatus.com/feature/4765305641369600

[Jochen Eisinger]

lgtm1

[Chris Harrelson]

The graph shows a steady value of 0.01%. Have you done research to find out which sites are using it?

lgtm1

--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.

[Philip Jägenstedt]

A look at httparchive would be very useful. I searched for pages contained 'MediaStreamTrack.getSources' and found a lot of polyfill code. Excluding resources that also contain 'enumerateDevices'  leaves only 88 results:

https://docs.google.com/a/chromium.org/spreadsheets/d/1lDqTpNGN0O0ceHplUWcS7K_99hYvSGTNnafPRUkRSI8/edit?usp=sharing

Guido, can you see if there are things that will break in here?

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.

[Dimitri]

LGTM2.

[Guido Urdaneta]

I checked several of the sites and I didn't find anything that would break in a major way.

Practically all call sites check if getSources is available, and they can all be easily ported to enumerateDevices.

For the sites I checked, getSources does not seem to be a major part of their functionality.

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.

[Chris Harrelson]

LGTM3

[Philip Jägenstedt]

This was an Intent to Remove, but unless there's any hurry, at least 1 milestones of deprecation would make sense. Does that sound good?

LGTM3

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.

[PhistucK]

You mean, one additional milestone, right? Since it is already deprecated.

☆PhistucK

LGTM3

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.

--
You received this message because you are subscribed to the Google Groups "blink-dev" group.

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+unsubscribe@chromium.org.

[Guido Urdaneta]

I will update the deprecation message to say that it will be removed in M56.

The current message does not say when it will be removed.

[Philip Jägenstedt]

I wasn't paying attention and didn't follow the link to the existing Intent to Deprecate, but yeah, just adding a removal milestone before the actual removal sounds good.

Another thing that came up in the API owners meeting is that it would be good with a simple polyfill that we can provide for those who have their site broken and just want to fix it with minimal effort. Something like:

if (window.MediaStreamTrack && !MediaStreamTrack.prototype.getSources) {

  MediaStreamTrack.prototype.getSources = function(callback) {

    /* something with enumerateDevices and a mapping */

  }

}

The possibility of this also proves that no functionality is being removed. But is it possible to provide the facing attribute using enumerateDevices?

☆PhistucK

LGTM3

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.

--
You received this message because you are subscribed to the Google Groups "blink-dev" group.

To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.