Change the way jQuery.data works so that there is no longer a chance …
…of collision between user data and internal data. Fixes #6968.
- Loading branch information
- +2 −2 src/attributes.js
- +107 −55 src/data.js
- +5 −5 src/effects.js
- +25 −21 src/event.js
- +21 −14 src/manipulation.js
- +2 −2 src/queue.js
- +4 −6 test/unit/attributes.js
- +162 −76 test/unit/data.js
- +2 −2 test/unit/effects.js
- +11 −9 test/unit/event.js
| @@ -1,7 +1,6 @@ | ||
| (function( jQuery ) { | ||
|
|
||
| var windowData = {}, | ||
| rbrace = /^(?:\{.*\}|\[.*\])$/; | ||
| var rbrace = /^(?:\{.*\}|\[.*\])$/; | ||
|
|
||
| jQuery.extend({ | ||
| cache: {}, | ||
| @@ -23,110 +22,163 @@ jQuery.extend({ | ||
| }, | ||
|
|
||
| hasData: function( elem ) { | ||
| if ( elem.nodeType ) { | ||
| elem = jQuery.cache[ elem[jQuery.expando] ]; | ||
| } | ||
| elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ]; | ||
|
|
||
| return !!elem && !jQuery.isEmptyObject(elem); | ||
| }, | ||
|
|
||
| data: function( elem, name, data ) { | ||
| data: function( elem, name, data, pvt /* Internal Use Only */ ) { | ||
| if ( !jQuery.acceptData( elem ) ) { | ||
| return; | ||
| } | ||
|
|
||
| elem = elem == window ? | ||
| windowData : | ||
| elem; | ||
| var internalKey = jQuery.expando, getByName = typeof name === "string", thisCache, | ||
|
|
||
| // We have to handle DOM nodes and JS objects differently because IE6-7 | ||
| // can't GC object references properly across the DOM-JS boundary | ||
| isNode = elem.nodeType, | ||
|
|
||
| // Only DOM nodes need the global jQuery cache; JS object data is | ||
| // attached directly to the object so GC can occur automatically | ||
| cache = isNode ? jQuery.cache : elem, | ||
|
|
||
| var isNode = elem.nodeType, | ||
| id = isNode ? elem[ jQuery.expando ] : null, | ||
| cache = jQuery.cache, thisCache; | ||
| // Only defining an ID for JS objects if its cache already exists allows | ||
| // the code to shortcut on the same path as a DOM node with no cache | ||
| id = isNode ? elem[ jQuery.expando ] : elem[ jQuery.expando ] && jQuery.expando; | ||
|
|
||
| if ( isNode && !id && typeof name === "string" && data === undefined ) { | ||
| // Avoid doing any more work than we need to when trying to get data on an | ||
| // object that has no data at all | ||
| if ( (!id || (pvt && id && !cache[ id ][ internalKey ])) && getByName && data === undefined ) { | ||
This comment has been minimized.
This comment has been minimized.
dmethvin
Member
|
||
| return; | ||
| } | ||
|
|
||
| // Get the data from the object directly | ||
| if ( !isNode ) { | ||
| cache = elem; | ||
| if ( !id ) { | ||
| // Only DOM nodes need a new unique ID for each element since their data | ||
| // ends up in the global cache | ||
| if ( isNode ) { | ||
| elem[ jQuery.expando ] = id = ++jQuery.uuid; | ||
| } else { | ||
| id = jQuery.expando; | ||
| } | ||
| } | ||
|
|
||
| // Compute a unique ID for the element | ||
| } else if ( !id ) { | ||
| elem[ jQuery.expando ] = id = ++jQuery.uuid; | ||
| if ( !cache[ id ] ) { | ||
| cache[ id ] = {}; | ||
This comment has been minimized.
BorisMoore
|
||
| } | ||
|
|
||
| // Avoid generating a new cache unless none exists and we | ||
| // want to manipulate it. | ||
| // An object can be passed to jQuery.data instead of a key/value pair; this gets | ||
| // shallow copied over onto the existing cache | ||
| if ( typeof name === "object" ) { | ||
| if ( isNode ) { | ||
| if ( pvt ) { | ||
| cache[ id ][ internalKey ] = jQuery.extend(cache[ id ][ internalKey ], name); | ||
| } else { | ||
| cache[ id ] = jQuery.extend(cache[ id ], name); | ||
| } | ||
| } | ||
|
|
||
| } else { | ||
| jQuery.extend( cache, name ); | ||
| thisCache = cache[ id ]; | ||
|
|
||
| // Internal jQuery data is stored in a separate object inside the object's data | ||
| // cache in order to avoid key collisions between internal data and user-defined | ||
| // data | ||
| if ( pvt ) { | ||
| if ( !thisCache[ internalKey ] ) { | ||
| thisCache[ internalKey ] = {}; | ||
| } | ||
|
|
||
| } else if ( isNode && !cache[ id ] ) { | ||
| cache[ id ] = {}; | ||
| thisCache = thisCache[ internalKey ]; | ||
| } | ||
|
|
||
| thisCache = isNode ? cache[ id ] : cache; | ||
|
|
||
| // Prevent overriding the named cache with undefined values | ||
| if ( data !== undefined ) { | ||
| thisCache[ name ] = data; | ||
| } | ||
|
|
||
| return typeof name === "string" ? thisCache[ name ] : thisCache; | ||
| return getByName ? thisCache[ name ] : thisCache; | ||
| }, | ||
|
|
||
| removeData: function( elem, name ) { | ||
| removeData: function( elem, name, pvt /* Internal Use Only */ ) { | ||
| if ( !jQuery.acceptData( elem ) ) { | ||
| return; | ||
| } | ||
|
|
||
| elem = elem == window ? | ||
| windowData : | ||
| elem; | ||
| var internalKey = jQuery.expando, isNode = elem.nodeType, | ||
|
|
||
| // See jQuery.data for more information | ||
| cache = isNode ? jQuery.cache : elem, | ||
|
|
||
| // See jQuery.data for more information | ||
| id = isNode ? elem[ jQuery.expando ] : jQuery.expando; | ||
|
|
||
| var isNode = elem.nodeType, | ||
| id = isNode ? elem[ jQuery.expando ] : elem, | ||
| cache = jQuery.cache, | ||
| thisCache = isNode ? cache[ id ] : id; | ||
| // If there is already no cache entry for this object, there is no | ||
| // purpose in continuing | ||
| if ( !cache[ id ] ) { | ||
| return; | ||
| } | ||
|
|
||
| // If we want to remove a specific section of the element's data | ||
| if ( name ) { | ||
| var thisCache = pvt ? cache[ id ][ internalKey ] : cache[ id ]; | ||
|
|
||
| if ( thisCache ) { | ||
| // Remove the section of cache data | ||
| delete thisCache[ name ]; | ||
|
|
||
| // If we've removed all the data, remove the element's cache | ||
| if ( isNode && jQuery.isEmptyObject(thisCache) ) { | ||
| jQuery.removeData( elem ); | ||
| // If there is no data left in the cache, we want to continue | ||
| // and let the cache object itself get destroyed | ||
| if ( !jQuery.isEmptyObject(thisCache) ) { | ||
| return; | ||
| } | ||
| } | ||
| } | ||
|
|
||
| // See jQuery.data for more information | ||
| if ( pvt ) { | ||
| delete cache[ id ][ internalKey ]; | ||
|
|
||
| // Don't destroy the parent cache unless the internal data object | ||
| // had been the only thing left in it | ||
| if ( !jQuery.isEmptyObject(cache[ id ]) ) { | ||
| return; | ||
| } | ||
| } | ||
|
|
||
| var internalCache = cache[ id ][ internalKey ]; | ||
|
|
||
| // Otherwise, we want to remove all of the element's data | ||
| // Browsers that fail expando deletion also refuse to delete expandos on | ||
| // the window, but it will allow it on all other JS objects; other browsers | ||
| // don't care | ||
| if ( jQuery.support.deleteExpando || cache != window ) { | ||
| delete cache[ id ]; | ||
| } else { | ||
| if ( isNode && jQuery.support.deleteExpando ) { | ||
| delete elem[ jQuery.expando ]; | ||
| cache[ id ] = null; | ||
| } | ||
|
|
||
| // We destroyed the entire user cache at once because it's faster than | ||
| // iterating through each key, but we need to continue to persist internal | ||
| // data if it existed | ||
| if ( internalCache ) { | ||
| cache[ id ] = {}; | ||
| cache[ id ][ internalKey ] = internalCache; | ||
|
|
||
| // Otherwise, we need to eliminate the expando on the node to avoid | ||
| // false lookups in the cache for entries that no longer exist | ||
| } else if ( isNode ) { | ||
| // IE does not allow us to delete expando properties from nodes, | ||
| // nor does it have a removeAttribute function on Document nodes; | ||
| // we must handle all of these cases | ||
| if ( jQuery.support.deleteExpando ) { | ||
| delete elem[ jQuery.expando ]; | ||
| } else if ( elem.removeAttribute ) { | ||
| elem.removeAttribute( jQuery.expando ); | ||
|
|
||
| // Completely remove the data cache | ||
| } else if ( isNode ) { | ||
| delete cache[ id ]; | ||
|
|
||
| // Remove all fields from the object | ||
| } else { | ||
| for ( var n in elem ) { | ||
| delete elem[ n ]; | ||
| } | ||
| elem[ jQuery.expando ] = null; | ||
| } | ||
| } | ||
| }, | ||
|
|
||
| // For internal use only. | ||
| _data: function( elem, name, data ) { | ||
| return jQuery.data( elem, name, data, true ); | ||
| }, | ||
|
|
||
| // A method for determining if a DOM node can handle the data expando | ||
| acceptData: function( elem ) { | ||
| if ( elem.nodeName ) { | ||
5 comments
on commit 8e59a99
This comment has been minimized.
This comment has been minimized.
|
Have you tested the impact on performance of such change? You are adding one more function call when using jQuery._data() instead of jQuery.data(). |
This comment has been minimized.
This comment has been minimized.
|
And what does "Internal Use Only" really means? Should plugin developers use it? |
This comment has been minimized.
This comment has been minimized.
|
@lrbabe, our intent with jQuery._data() is to prevent name collisions between internal jQuery data and external data attached by user code or plugins. Plugin developers should continue to use jQuery.data() or $().data() but of course they can use their own conventions to avoid collisions there, such as prepending "myPlugin" to the name of each data item or creating a master "myPlugin" object that contains all the data. |
This comment has been minimized.
This comment has been minimized.
|
Thank you for these explanations @dmethvin. |
This comment has been minimized.
This comment has been minimized.
|
@lrbabe, we discussed and didn't think an extra function call would make too much difference. If you'd like to create some benchmarks to show a performance hit, we could take a look. |
We are having problems with this line on IE7. I have an empty DOM node that I've inserted into the page with a jQuery template. I call empty() on it, and-- on IE7-- it croaks. Actually, it seems like it works once, but then not the second time, but I don't have a good Javascript tracing setup working, and using alerts() doesn't work, since this method appears to be called 100s of times.
I'm getting the IE equivalent of a NPE. In our case, it appears that cache[id] is not set, even though pvt and id are, and therefore we are getting an error.
Anyway, I am able to "fix" the problem by substituting "(!cache[id] || !cache[id][internalKey])"
I have no idea if this is right.
Would appreciate some guidance. I'm not sure what is actually necessary to reproduce and test, since I'm not familiar with the intent of this code.