From 6372d6dd7198f2d412e473e6e0a0a2dfbfd37bf5 Mon Sep 17 00:00:00 2001 From: ahmedmoussa10 Date: Thu, 25 Sep 2025 14:41:52 -0700 Subject: [PATCH 1/5] Clarify that browsers can use internally-available information about the devices over ideal constraints Link to specs: https://w3c.github.io/mediacapture-main/ --- files/en-us/web/api/mediadevices/getusermedia/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/mediadevices/getusermedia/index.md b/files/en-us/web/api/mediadevices/getusermedia/index.md index 6e8ba3d99f3dda9..e1f0eaf33839108 100644 --- a/files/en-us/web/api/mediadevices/getusermedia/index.md +++ b/files/en-us/web/api/mediadevices/getusermedia/index.md @@ -299,7 +299,7 @@ getUserMedia({ }); ``` -The above will return the camera you requested, or a different camera if that specific camera is no longer available. +The above will return the camera you requested, or a different camera based on internally-available information to the browsers, such as user preference or that specific camera no longer available. Again, to _require_ the specific camera, you would use: ```js From 42f1275463d7e7d2d9c74db1494c9843aee6faec Mon Sep 17 00:00:00 2001 From: ahmedmoussa10 Date: Tue, 14 Oct 2025 10:18:31 -0700 Subject: [PATCH 2/5] Fix typo --- files/en-us/web/api/mediadevices/getusermedia/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/mediadevices/getusermedia/index.md b/files/en-us/web/api/mediadevices/getusermedia/index.md index e1f0eaf33839108..e2e1817ede7421e 100644 --- a/files/en-us/web/api/mediadevices/getusermedia/index.md +++ b/files/en-us/web/api/mediadevices/getusermedia/index.md @@ -299,7 +299,7 @@ getUserMedia({ }); ``` -The above will return the camera you requested, or a different camera based on internally-available information to the browsers, such as user preference or that specific camera no longer available. +The above will return the camera you requested, or a different camera based on internally-available information to the browsers, such as user preference or if that specific camera no longer available. Again, to _require_ the specific camera, you would use: ```js From ee630c57d0fe9a7603cb17396ef7da73115613f3 Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Thu, 23 Oct 2025 22:47:53 -0400 Subject: [PATCH 3/5] Explain user preference in more detail --- files/en-us/web/api/mediadevices/getusermedia/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/files/en-us/web/api/mediadevices/getusermedia/index.md b/files/en-us/web/api/mediadevices/getusermedia/index.md index e2e1817ede7421e..f51238f45d987c1 100644 --- a/files/en-us/web/api/mediadevices/getusermedia/index.md +++ b/files/en-us/web/api/mediadevices/getusermedia/index.md @@ -299,7 +299,9 @@ getUserMedia({ }); ``` -The above will return the camera you requested, or a different camera based on internally-available information to the browsers, such as user preference or if that specific camera no longer available. +The above will return the camera you requested, or a different camera if that specific camera no longer available. +Browsers' internally-available information, such as user preference, may also override your request. +For example, when the user was asked for camera permissions, the camera they selected may be used instead of the one you requested. Again, to _require_ the specific camera, you would use: ```js From 046e6482aa38517b2ae1facf4fd1a8d55bb8c330 Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Thu, 23 Oct 2025 22:48:21 -0400 Subject: [PATCH 4/5] Update files/en-us/web/api/mediadevices/getusermedia/index.md --- files/en-us/web/api/mediadevices/getusermedia/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/mediadevices/getusermedia/index.md b/files/en-us/web/api/mediadevices/getusermedia/index.md index f51238f45d987c1..3fd4dd6179a6614 100644 --- a/files/en-us/web/api/mediadevices/getusermedia/index.md +++ b/files/en-us/web/api/mediadevices/getusermedia/index.md @@ -299,7 +299,7 @@ getUserMedia({ }); ``` -The above will return the camera you requested, or a different camera if that specific camera no longer available. +The above will return the camera you requested, or a different camera if that specific camera is no longer available. Browsers' internally-available information, such as user preference, may also override your request. For example, when the user was asked for camera permissions, the camera they selected may be used instead of the one you requested. Again, to _require_ the specific camera, you would use: From 55f14dbf9562e555ecac564223dfc6f3dde2bef5 Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Thu, 23 Oct 2025 22:50:45 -0400 Subject: [PATCH 5/5] Update files/en-us/web/api/mediadevices/getusermedia/index.md --- files/en-us/web/api/mediadevices/getusermedia/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/en-us/web/api/mediadevices/getusermedia/index.md b/files/en-us/web/api/mediadevices/getusermedia/index.md index 3fd4dd6179a6614..551694dd7c47c48 100644 --- a/files/en-us/web/api/mediadevices/getusermedia/index.md +++ b/files/en-us/web/api/mediadevices/getusermedia/index.md @@ -301,7 +301,7 @@ getUserMedia({ The above will return the camera you requested, or a different camera if that specific camera is no longer available. Browsers' internally-available information, such as user preference, may also override your request. -For example, when the user was asked for camera permissions, the camera they selected may be used instead of the one you requested. +For example, when the user was asked for camera permissions, the camera they selected may take priority over the one you requested. Again, to _require_ the specific camera, you would use: ```js