SelectMediaDeviceResponse

Value the selectMediaDevice handler’s promise resolves with.

The resolved value must be one of the ids of the devices from SelectMediaDeviceParams.devices or one of the following reserved strings:

• 'cancel' — offer no device of the type this invocation was given. Only that type is dropped; a type offered by another invocation is unaffected.
• 'proceed' — leave the offered devices as they are, so the page sees all of them.

An id that matches none of the offered devices leaves the page with no device of that type, which is the same outcome as 'cancel'. Resolving with a non-string value (including the undefined of a handler that returns nothing) or rejecting the promise is treated as 'proceed'.

The promise must settle. Until it does, the page’s enumerateDevices() and getUserMedia() calls stay pending, so a handler that awaits a prompt should resolve it — with 'cancel' or 'proceed' — when the prompt is dismissed.

type SelectMediaDeviceResponse = string;