Connection Manager Release Notes *** version 2.4.1 *** No change *** version 2.4.0 *** * [FIXED] SF1804153. Transactions initialized with setForm() now properly clear the POST data field after each transaction. * The callback object can accept a new member, cache, defined with a boolean value. If set to false (e.g., var callback = { cache:false };), a timestamp will be appended to the URI to override HTTP GET caching. This timestamp value will appear as rnd=timestamp in the request querystring. * Custom Events startEvent, completeEvent, and abortEvent now receive callback.argument, if defined, in addition to the transaction ID. Each Custom Event's function handler receives two arguments -- the event type as the first argument, and an array as the second argument. The first element in the array is the transaction ID, and the second element are any arguments defined in the callback object. *** version 2.3.1 *** * setDefaultPostHeader() can now be overloaded with a boolean, string, or number. By default, POST transactions send the following Content-Type header: 'application/x-www-form-urlencoded; charset=UTF-8'. A custom Content-Type header can now be set by passing its value to setDefaultPostHeader(). * HTML form submissions now send a Content-Type header of "application/x-www- form-urlencoded", omitting the charset=UTF-8 value. * setDefaultXhrHeader() can now be overloaded with a boolean, string, or number. By default, all transactions send a custom header of "X-Requested- With:XMLHttpRequest". This default header value can be overridden by passing the desired value as an argument to setDefaultPostHeader(). * The file upload iframe's event listener is now explicitly removed before the iframe is destroyed. *** version 2.3.0 *** * Custom Events are introduced in Connection Manager. These events -- for a non-file upload transaction -- are: * startEvent * completeEvent * successEvent * failureEvent * abortEvent For transactions involving file upload with an HTML form, the events are: * startEvent * completeEvent * uploadEvent * abortEvent * Event utility is a now Connection Manager dependency. * abort() and isCallInProgress() are now functional for file upload transactions. * NOTE: The native XHR implementation in Safari 2.0.4 has been confirmed to leak memory. * UPDATE: The XHR implementation in Safari 3.0 beta(and WebKit builds) now appear to handle HTTP 204 responses correctly. XHR in Opera, as of 9.21, still does not produce a valid HTTP status code with an HTTP 204 response. *** version 2.2.2 *** * No revisions. *** version 2.2.1 *** * setForm() will include the correct name-value of the HTML Submit button clicked where multiple HTML Submit button options are present in an HTML form. To enable this feature, include the Event utility source file as a dependency before the Connection Manager source file. * The XHR implementation in IE6 and IE7, Opera, and Safari do not properly handle an HTTP 204 response. IE6/7 will instead return a Win error 1223. handleTransactionResponse() will treat 1223 as an HTTP 204, and route the response appropriately to the success callback. createResponseObject() will normalize the response object's status and statusText values to 204 and "No Content" respectively. However, no headers are returned. Opera and Safari provide no discernable response with HTTP 204(e.g., response object's properties are undefined). This response will trigger the failure callback with a status of 0 and statusText of "communication failure". *** version 2.2.0 *** * initHeader() now accepts a third argument as a boolean. When set to true, this specific header will automatically be sent with each transaction. Otherwise, the header will be set and sent for the specific transaction only. Example: initHeader('X-YUI-State','Beta', true); all transactions will send this header. * resetDefaultHeaders() will clear the default headers collection. * All Connection Mananger transactions will broadcast the header: "X-Requested- With: XMLHttpRequest". * This can be turned off: YAHOO.util.Connect.setDefaultXhrHeader(false); * The HTTP method argument in asyncRequest is now case-insensitive. * uploadFile() will now correctly handle the absence of a callback object, allowing the transaction to complete silently. *** version 0.12.2 *** * The Opera/Connection Manager concurrent object condition, described in version 0.12.0, no longer tests applies for Opera, version 9.10. *** version 0.12.1 *** * connection-debug.js corrected and synchronized with connection.js. Code inconsistencies between the two files existed in 0.12.0. *** version 0.12.0 *** * When uploading files via setForm() and asyncRequest includes a POST data argument, appendPostData() will create hidden input fields for each postData label/value and append each field to the form object. * setForm() returns the assembled label/value string of the parsed HTML form fields. * NOTE: Opera 9.02 does not allow for more than 12 concurrent Connection Manager objects. The following example creates 12 requests in a loop: for(var n=0; n<=12; i++){ conn[n] = YAHOO.util.Connect.asyncRequest('GET', sUrl, callback); } If n > 13, Opera 9.02 will crash. Connection manager objects count n must be <= 12 at all times. This condition was not present in Opera version 9.01. This condition does not apply to other A-Grade browsers ( http://developer.yahoo.com/yui/articles/gbs/gbs_browser-chart.html) *** version 0.11.3 *** * YUI Event dependency for file uploading is now optional. * uploadFile() now sets unique IDs for each file upload transaction to prevent iframe collisions with parallel uploads. * The callback object now has property responseXML to provide support for file upload transactions that return an XML document. * setForm() will verify if a select option value attribute is present and use its value, including empty string, before using the text node value. * Modified polling mechanism in handleReadyState() and handleTransactionResponse() to prevent infinite polling if JavaScript errors occur in the user-defined callback. * createFrame() will now accept a boolean argument of true to set the frame source to "javascript:false" to prevent IE from throwing security warnings in an HTTPS environment. * setHeader() now enumerates through the _http_header object using hasOwnProperty() to prevent collisions with members added to Object via prototype. * If using setForm() and asyncRequest includes a POST data argument, the data will be concatenated to the HTML form POST message. *** version 0.11.2 *** * No revisions. *** version 0.11.1 *** * uploadFile() now verifies the existence of callback.upload before invoking callback, with or without object scope. *** version 0.11.0 *** * Each transaction can be defined with a timeout threshold, in milliseconds, through the callback object. If the threshold is reached, and the transaction hasn't yet completed, the transaction will call abort(). * abort() will now accept a callback object as the second argument. The failure callback will receive a response object to indicate the transaction was aborted. * setForm() will now support file uploads by setting the second argument to true (e.g., YAHOO.util.Connect.setForm(formObject, true). File upload does not use the callback success or failure handler. Instead, it uses a new callback object handler: upload. * HTML form submit will no longer submit form fields without a defined name attribute. * The default POST header of 'Content-Type','application/x-www-form-urlencoded' can be overridden by calling setDefaultPostHeader(false). This will remove the default header from non-HTML form, POST submissions. * setHeader() now enumerates through the _http_header object with propertyIsEnumerable to prevent collisions with members added to Object via prototype. *** version 0.10.0 *** * handleTransactionResponse() now treats the full HTTP 2xx range as a success case, instead of just HTTP 200. * To accommodate multiple field values in Mozilla/Firefox, multiple initHeader calls with the same label will now result in the values concatenated to a comma- delimited string value. Example: Setting Content-Type:'application/x-www-form-urlencoded' and Content- Type:'text/xml' will result in Content-Type:'application/x-www-form-urlencoded, text/xml'. * Default polling interval lowered to 50ms. * YAHOO.util.Connect.setPollingInterval() will allow you to set a polling interval -- in milliseconds -- to override the default value. * YAHOO.util.Connect.getResponseHeader[headerLabel] now supported as a response object property to provide symmetry with the native XHR object's property. Example: YAHOO.util.Connect.getResponseHeader['Content-Length'] will return the value for the Content-Length header, if the header is available. * YAHOO.util.Connect.allResponseHeaders property renamed to getAllResponseHeaders to provide symmetry with the native XHR object's property. * YAHOO.util.Connect.setForm() now supports HTTP GET as well as HTTP POST. * YAHOO.util.Connect.setForm() now accepts an HTML form object as well as its name attribute value. * YAHOO.util.Connect.setForm() will not submit HTML form fields that are disabled or do not have a name attribute value. * [FIXED] Response exceptions result in infinite callback loop in Mozilla/Firefox. * [FIXED] YAHOO.util.Connect.abort() now properly clears polling interval. * [FIXED] isCallInProgress() now verifies whether XHR instance still exists, and returns false if the connection object is no longer available. *** version 0.9.0 *** * Initial release