XMLSocket.onData()

Availability

Flash Player 5.

Usage

XMLSocket.onData = function(src) {
  // your statements here
}

Parameters

src A string containing the data sent by the server.

Returns

Nothing.

Description

Event handler; invoked when a message has been downloaded from the server, terminated by a zero byte. You can override XMLSocket.onData to intercept the data sent by the server without parsing it as XML. This is a useful if you're transmitting arbitrarily formatted data packets, and you'd prefer to manipulate the data directly when it arrives, rather than have Flash Player parse the data as XML.

By default, the XMLSocket.onData method invokes the XMLSocket.onXML method. If you override XMLSocket.onData with your own behavior, XMLSocket.onXML will no longer be called unless you call it in your implementation of XMLSocket.onData.

XMLSocket.prototype.onData = function (src) {
  this.onXML(new XML(src));
}

In the above example, the src parameter is a string containing XML text downloaded from the server. The zero byte terminator is not included in the string.