# <object>

Description

Allows interaction with a custom extension. A VoiceXML platform may have platform-specific functionality that an application wants to use, such as speaker verification, native components, additional telephony, etc. Such platform-specific objects are accessed using the `<object>` element, which is analogous to the HTML <OBJECT> element.

Syntax

    <object
        name="string"
        expr="ECMAScript_Expression"
        cond="ECMAScript_Expression"
        classid="URI"
        codebase="URI"
        codetype="string"
        data="URI"
        type="string"
        archive="URI"
        fetchhint="prefetch" | "safe"
        fetchtimeout="time_interval"
        maxage="integer"
        maxstale="integer">
      child elements
    </object>

Attributes

Attribute | Description
name | The name of this object. This variable can be referenced anywhere within the object's form. Optional. (Defaults to an inaccessible internal variable.)
expr | An ECMAScript expression to be evaluated and used as the initial value of this object. This object will be visited only if the expression evaluates to `undefined`. Optional. (Defaults to undefined.)
cond | An ECMAScript expression to be evaluated and used as a boolean condition. This object will be visited only if the expression evaluates to `true`. Optional. (Defaults to true.)
classid | The URI specifying the location of the object's implementation. Optional.
codebase | The base path used to resolve relative URIs specified by `classid`, `data`, and `archive`. Optional. (Defaults to base URI of current document.)
codetype | The content type of data expected when downloading the object specified by `classid`. Optional. (Defaults to the value of the type attribute.)
data | The URI specifying the location of the object's data. If it is a relative URI, it is interpreted relative to the `codebase` attribute. Optional.
type | The content type of the data specified by the `data` attribute. Optional.
archive | A space-separated list of URIs for archives containing resources relevant to the object, which may include the resources specified by the `classid` and `data` attributes. URIs which are relative are interpreted relative to the `codebase` attribute. Optional.
fetchhint | Defines when the object should be fetched. Optional. prefetch - object may be downloaded when the page is loaded safe - only load the object when needed
fetchtimeout | The length of time to wait for the object to be fetched before throwing an `error.badfetch` event. Optional.
maxage | Indicates that this document is willing to use a cached copy of the object only while the age of the cached copy is less than or equal to the number of seconds specified by this attribute. Optional.
maxstale | Indicates that this document is willing to use a cached copy of the object that has exceeded its expiration time by as much as the number of seconds specified by this attribute. Optional.

Parents

<form>

Children

<audio>, <catch>, <error>, <filled>, <help>, <noinput>, <nomatch>, <param>, <prompt>, <property>, <value>, #PCDATA

Extensions

None.

Limitations/Restrictions

- No IP Media Server platform-specific objects are currently defined. Therefore, any use of <object> will result in an error being thrown:
  `error.unsupported.objectname` will be thrown (where `objectname` is a fixed string; it is not substituted with the name of the object).