import v1.0.0-RC4 | 2009-05-20
This commit is contained in:
302
webdir/javascript/yui/connection/README
Normal file
302
webdir/javascript/yui/connection/README
Normal file
@ -0,0 +1,302 @@
|
||||
Connection Manager Release Notes
|
||||
|
||||
*** version 2.6.0 ***
|
||||
|
||||
* setForm optimization for select-one elements.
|
||||
|
||||
* File upload transactions that include encoded POST data will have the keys and
|
||||
values decoded before they are used to create the form fields, to avoid having
|
||||
the data encoded twice.
|
||||
|
||||
*** version 2.5.2 ***
|
||||
|
||||
* In file upload transactions, in Safari 3.x, fail to send the file data. This
|
||||
is due to Safari evaluating the condition statement "if(formObject.encoding){}"
|
||||
as true. This results in the incorrect attribute being set, the correct
|
||||
attribute being "enctype." The conditional check now explicitly verifies for
|
||||
IE, before setting the appropriate attribute.
|
||||
|
||||
* NOTE: File uploads using setForm() does not function as expected in Opera
|
||||
9.27. The file and data upload phase works as expected, however the server
|
||||
response cannot be read. Specifically, "onload" for an iframe is triggered when
|
||||
the iframe is appended into the DOM. This results in the upload callback being
|
||||
fired immediately, before the transaction is complete, and before the response
|
||||
data are available.
|
||||
|
||||
This condition is documented in Opera's bug tracking system: 295719 and appears
|
||||
to have been fixed as of Opera 9.50 b2.
|
||||
|
||||
*** version 2.5.1 ***
|
||||
|
||||
* no changes.
|
||||
|
||||
*** version 2.5.0 ***
|
||||
|
||||
* setForm() can now detects HTTPS in the URI for file upload transactions. The
|
||||
third, boolean argument for HTTPS when using IE is no longer necessary.
|
||||
|
||||
* [FIXED] SF1882101. POST transactions without a message will now have a
|
||||
Content-Length value set to 0 for FF 2.x. This is accomplished by passing a
|
||||
value of empty string instead of null to XHR's send(). All other A-Grade
|
||||
browsers remain unaffected and perform correctly.
|
||||
|
||||
*** 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
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
Reference in New Issue
Block a user