1312175 - Navigator.getUserMedia() is deprecated (!) (?)

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: API: WebRTC, defect, P5)

Description

[pitoti]

:: Developer Documentation Request

      Request Type: Correction
     Gecko Version: unspecified
 Technical Contact: 

:: Details

In this article ( https://developer.mozilla.org/en-US/docs/Web/API/WebRTC_API/Taking_still_photos ), the code use:
  Navigator.getUserMedia() 

But, in this page ( https://developer.mozilla.org/en-US/docs/Web/API/Navigator/getUserMedia ) there are two notes, about this feature deprecated and new use of MediaDevices.getUserMedia()

It is also a bit confusing, see in ( https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices ) says that this feature ( MediaDevices.getUserMedia() ) is experimental

Comment 1

[Eric Shepherd [:sheppy]]

I've done some cleanup work here:

I've redone the text in Navigator.getUserMedia() to be clearer. I've also created a redirect at Navigator.mediaDevices.getUserMedia() so that links to there redirect to MediaDevices.getUserMedia() so they will present the needed information.

Primarily, I explain that getUserMedia() was moved to MediaDevices and now uses promises, but for backward compatibility, the spec has at least temporarily retained the old version of the function; however, there's no guarantee as to how long it will be there, so we recommend it not be used, that old code be redone, and that for that reason, we treat it as if it were fully deprecated.