MDN self-hosted library · e01.org

RemotePlayback: cancelWatchAvailability() method

Remote Playback API

Remote Playback API

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

Syntax

cancelWatchAvailability()
cancelWatchAvailability(id)

Parameters

  • id
  • : 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().

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

Browser compatibility