error

Article
03/26/2013

error element

Handles errors thrown by the platform or throw element.

Syntax

<error 
cond = "ECMAScript_Expression"
count = "integer"
/>

Attributes

cond	A condition that must evaluate to true for this element to be selected by the form interpretation algorithm.
count	Used by the VoiceXML interpreter in the event handler selection process, allowing the developer to handle multiple occurrences of the error event in a unique manner. The default value is 1.

Parents

field, form, initial, menu, object, record, subdialog, transfer, vxml

Children

assign, audio, break, clear, data, disconnect, enumerate, exit, foreach, goto, if, log element, mark, prompt, prompt, return, script, submit, throw, value, var

Remarks

The error event is shorthand for a catch element with its event attribute set to "error."

The error event handler catches error events thrown by the Platform or by the throw element.

To catch a user-defined event using the error element, prefix the name of the user-defined event with "error," for example, "error.myevent."

Examples

The following example references a non-existent external grammar file. The error event catches the error, plays a message to the user, and disconnects.

<?xml version="1.0"?>
<vxml version="2.1"
 xmlns="http://www.w3.org/2001/vxml">
  <!-- this error handler will catch any error event in this document -->
  <error>
    A fatal error occurred. Please contact a customer service representative.
    <disconnect/>
  </error>

  <form>
    <field name="get_fruit">

      <prompt>
      Pick a fruit
      </prompt>

      <!-- The URI is invalid. The platform will throw error.badfetch. -->
      <grammar mode="voice" type="application/srgs+xml"
         src="http://badserver/badvroot/badfile.grammar" />

    </field>
  </form>
</vxml>