TelephonyCallGroup.onheld

This API is available on Firefox OS for internal applications only.

The onheld property of the Telephony interface specifies an event listener to receive held events. These events occur when the call group is successfully put on hold.

Syntax

JavaScript
myTelephonyCallGroup.onheld = function() { ... };

These events are of type CallEvent.

Examples

JavaScript
// Telephony object
var tel = navigator.mozTelephony;

// Make two calls; assume they are both answered
var call1, call2;
tel.dial(number1).then(call => call1 = call);
tel.dial(number2).then(call => call2 = call);

// Add both calls to the conference call
// Two entries will appear in conference.calls (call1, call2)
// but nothing in tel.calls
var conference = tel.conferenceGroup;
conference.add(call1, call2);

conference.onheld = function() {
  // Do something when the conference call
  // is successfully held
};

Specifications

Specification Status Comment
Web Telephony Draft Draft

Browser compatibility

For obvious reasons, support is primarily expected on mobile browsers.

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support No support No support No support No support No support
Feature Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support No support 12.0 (12.0) 1.0.1 No support No support No support

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/telephonycallgroup/onheld

API B2G Certified DOM DOM Reference Events events Firefox OS Mobile Non-standard onheld Property Reference Telephony TelephonyCallGroup