SIP Objects

The SIP object model contains both objects that correspond directly to SIP headers and objects that correspond to common information that occurs in multiple headers. The common objects can be viewed as being embedded in the other SIP header objects and can be accessed as properties of the SIP header objects.

Authorization

Parses and serializes for the SIP Authorization header.

.scheme
Type:

String

Description:

The parsed authentication scheme, such as Digest or Basic.

.token
Type:

String

Description:

A parsed single encrypted security token used for certain authentication schemes.

SipAccept

Indicates the content types that are accepted.

.contentTypes
Type:

Array

Description:

Array of SipContentType objects.

SipCallID

Identifies a particular invitation or all registrations of a particular client.

.localId
Type:

String

Description:

Local ID portion of the call ID. For example, 1234 in 1234@host.com.

.host
Type:

String

Description:

Host name portion of the call ID.

SipContact

Accepts any Contact header value and provides parsing and serialization.

.is_wildcard
Type:

Boolean

Description:

True if the object represents the special value * for a Contact header.

.nameAddrs
Type:

Array

Description:

Array of SipNameAddr objects corresponding to the list of contact values.

SipContentType

Indicates the type of content in the message.

.type
Type:

String

Description:

Content type. For example, application in application/sdp.

.subtype
Type:

String

Description:

Content subtype. For example, sdp in application/sdp.

.attribute
Type:

String

Description:

Optional attribute. For example, level in application/sdp;level=1.

SipCSeq

Indicates the order of transactions within a dialog, provides a means to uniquely identify transactions, and differentiates between new requests and retransmissions.

.value
Type:

Integer

Description:

Cseq integer value. For example, 1 in 1 INVITE.

.method
Type:

String

Description:

Method value. For example, INVITE in 1 INVITE.

Methods

increment()
Type:

NA

Description:

Increments the Value field of the Cseq header and leaves the method unchanged.

SipFrom

Indicates the initiator of the request, which can be different from the initiator of the dialog.

.displayName
Type:

String

Description:

Display Name field in the SIP message.

.url
Type:

SipUrl

Description:

URL in the SIP message.

.tag
Type:

String

Description:

Tag field in the SIP message.

SipNameAddr

.displayName
Type:

String

Description:

Display Name field in the SIP message.

.url
Type:

SipUrl

Description:

URL in the SIP message.

.tag
Type:

String

Description:

Tag field in the SIP message.

Note

A SipNameAddr entity consists of an optional display name followed by a mandatory URL. SipNameAddr entities appear in many SIP headers.

SipRecordRoute

Inserted by proxies in a request to force future requests in the dialog to be routed through the proxy.

.nameAddrs
Type:

Array

Description:

Array of SipNameAddr objects corresponding to the Record-Route entries.

SipRequestUri

Used to manipulate the Request-URI of the SIP request message.

.url
Type:

SipUrl

Description:

URL included in the request.

.protocol
Type:

String

Description:

Protocol used for the request.

.version
Type:

String

Description:

Version of protocol used for the request.

SipRetryAfter

Used with an error response to indicate how long the service is expected to be unavailable to the requesting client.

.date
Type:

Date

Description:

ECMAScript date object corresponding to the date, if provided, in the header.

.duration
Type:

Integer

Description:

Value of the duration parameter in the SIP message.

.deltaSeconds
Type:

Integer

Description:

Delta-seconds value, if provided, in the header.

.comment
Type:

String

Description:

Comment field in the SIP message.

SipRoute

Used to force routing for a request through the listed set of proxies.

.nameAddrs
Type:

Array

Description:

Array of SipNameAddr objects corresponding to the Record-Route entries.

SipTo

Specifies the logical recipient of the request.

.displayName
Type:

String

Description:

Display Name field in the SIP message.

.url
Type:

SipUrl

Description:

URL in the SIP message.

.tag
Type:

String

Description:

Tag field in the SIP message.

SipURL

Indicates an address that conforms to the SIP addressing scheme and represents the location of the user agent or service.

.prefix
Type:

String

Description:

Prefix of the URL. For example, sip, tel, etc.

.user
Type:

String

Description:

User name in the URL. For example, john in john:example@company.com.

.password
Type:

String

Description:

Password in the URL. For example, example in john:example@company.com.

.host
Type:

Integer

Description:

Host name in the URL. For example, company.com in john:example@company.com.

.port
Type:

String

Description:

Port number in the URL. For example, 5060 in company.com:5060.

.tag
Type:

String

Description:

Tag parameter in the URL, if present.

.userparam
Type:

String

Description:

User parameter in the URL, if present.

.maddr
Type:

String

Description:

Maddr parameter in the URL, if present.

.transport
Type:

String

Description:

Transport parameter in the URL, if present. For example, udp in john@company.com;transport=udp.

.ttl
Type:

String

Description:

Time to live parameter in the URL, if present.

.method
Type:

String

Description:

Method parameter in the URL, if present.

.phoneNumber
Type:

String

Description:

Phone number in the URL, which is valid only if user=phone is a URL parameter. For example, +15551212 in sip:+15551212@company.com;user=phone.

.postdial
Type:

String

Description:

Postd parameter in the URL, if present.

.isdn
Type:

String

Description:

Isub parameter in the URL, if present.

.parms
Type:

Array

Description:

Array of strings corresponding to the parameters found in the URL (other than those parameters already mentioned).

.headers
Type:

Array

Description:

Array of strings corresponding to the headers found in the URL.

.cic
Type:

String

Description:

Carrier Identification Code.

.dtg
Type:

String

Description:

Destination Trunk Group.

.method
Type:

String

Description:

Particular SIP message type of INVITE, ACK, BYE, CANCEL, REGISTER, or OPTIONS.

.oli
Type:

String

Description:

Originating Line Information.

.otg
Type:

String

Description:

Originating Trunk Group.

SipVia

Indicates the path taken by the request so far and the path that should be followed in routing responses.

.branch
Type:

String

Description:

Branch parameter on the Via.

.comment
Type:

String

Description:

Comment field, if present.

.protocol
Type:

String

Description:

Protocol used for the message.

.transport
Type:

String

Description:

Transport protocol.

.version
Type:

String

Description:

Version of protocol used for the message.

.parameters
Type:

Array

Description:

Key/value pairs of all parameters other than branch.

.host
Type:

String

Description:

Host part of the message.

.port
Type:

Number

Description:

Port part of the message.

SipViaArray

.vias
Type:

String

Description:

Array of SipVia objects.