RemotePlayback: cancelWatchAvailability() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.
Please take two minutes to fill out our short survey.

The cancelWatchAvailability() method of the RemotePlayback interface cancels the request to watch for one or all available devices.

Syntax

js
cancelWatchAvailability()
cancelWatchAvailability(id)

Parameters

id Optional

The callbackId of a particular remote playback device.

If a callbackId of a specific device is passed in, then that device will be removed from the list of watched devices. Otherwise, the whole list will be cleared.

Return value

A Promise that resolves with undefined.

Exceptions

InvalidStateError DOMException

Thrown if disableRemotePlayback is true for the media element.

NotFoundError DOMException

Thrown if an id is passed but it does not match any available callbackId.

Examples

Once a remote playback device has been identified and is connected, the monitoring of available devices can be stopped using cancelWatchAvailability().

js
function switchToRemoteUI() {
  // Indicate that the state is 'connecting' or 'connected' to the user.
  // For example, hide the video element as only controls are needed.
  videoElem.style.display = "none";

  // Stop monitoring the availability of remote playback devices.
  videoElem.remote.cancelWatchAvailability();
}

Specifications

Specification
Remote Playback API
# dom-remoteplayback-cancelwatchavailability

Browser compatibility