gecko/dom/webidl/MozVoicemailStatus.webidl

48 lines
1.5 KiB
Plaintext

/* -*- Mode: c++; c-basic-offset: 2; indent-tabs-mode: nil; tab-width: 40 -*- */
/* vim: set ts=2 et sw=2 tw=40: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
[Pref="dom.voicemail.enabled",
CheckAnyPermissions="voicemail",
AvailableIn="CertifiedApps"]
interface MozVoicemailStatus
{
readonly attribute unsigned long serviceId;
/**
* Whether or not there are messages waiting in the voicemail box
*/
readonly attribute boolean hasMessages;
/**
* The total message count. Some voicemail indicators will only specify that
* messages are waiting, but not the actual number. In that case, the value
* of messageCount will be -1, indicating the unknown message count.
*
* Logic for a voicemail notification might look something like:
* if (status.hasMessages) {
* // show new voicemail notification
* if (status.messageCount > 0) {
* // add a label for the message count
* }
* } else {
* // hide the voicemail notification
* }
*/
readonly attribute long messageCount;
/**
* Return call number received for this voicemail status, or null if one
* wasn't provided.
*/
readonly attribute DOMString? returnNumber;
/**
* Displayable return call message received for this voicemail status, or null
* if one wasn't provided.
*/
readonly attribute DOMString? returnMessage;
};