This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The RTCDTMFToneChangeEvent()
constructor creates a new RTCDTMFToneChangeEvent
.
Syntax
var event = new RTCDTMFToneChangeEvent(type, options);
Parameters
type
- A
DOMString
containing the name of the event. This is always"tonechange"
. options
- A dictionary of type
RTCDTMFToneChangeEventInit
, which may contain one or more of the following fields:tone
- A
DOMString
containing a single DTMF tone character which has just begun to play, or an empty string (""
) to indicate that the previous tone has stopped playing. See Tone characters for details on what characters are permitted.
Return value
A newly-created RTCDTMFToneChangeEvent
, configured as specified in the provided options.
Tone characters
- The digits 0-9
- These characters represent the digit keys on a telephone keypad.
- The letters A-D
- These characters represent the "A" through "D" keys which are part of the DTMF standard but not included on most telephones. These are not interpreted as digits. Lower-case "a"-"d" automatically gets converted to upper-case.
- The pound/hash sign ("#") and the asterisk ("*")
- These correspond to the similarly-labeled keys which are typically on the bottom row of the telephone keypad.
- The comma (",")
- This character instructs the dialing process to pause for two seconds before sending the next character in the buffer.
All other characters are unrecognized and will cause insertDTMF()
to throw an InvalidCharacterError
exception.
Specifications
Specification | Status | Comment |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCDTMFToneChangeEvent()' in that specification. |
Candidate Recommendation | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
RTCDTMFToneChangeEvent() constructor | Chrome Full support 27 | Edge Full support ≤18 | Firefox Full support 52 | IE No support No | Opera Full support Yes | Safari ? | WebView Android Full support 4.4 | Chrome Android Full support 27 | Firefox Android Full support 52 | Opera Android Full support Yes | Safari iOS ? | Samsung Internet Android Full support 1.5 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
See also
- WebRTC
- Using DTMF with WebRTC
- Its usual target:
RTCDTMFSender
.