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

The onheld event handler of the TelephonyCall interface is a reference to a function to be called when the current call has been held.

The event handler is called with a CallEvent as its only parameter.


myCall.onheld = function() { ... };


// Telephony object
var tel = navigator.mozTelephony;

// Place a call
tel.dial("123456789").then(function(call) {

  call.onheld = function(e) {
    console.log('Your call to ' + + ' has successfully been put on hold.');


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

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, teoli
 Last updated by: chrisdavidmills,