test/unit/data.js

   1 module("data", { teardown: moduleTeardown });
   2
   3 test("expando", function(){
   4         expect(1);
   5
   6         equals("expando" in jQuery, true, "jQuery is exposing the expando");
   7 });
   8
   9 function dataTests (elem) {
  10         // expect(32)
  11
  12         function getCacheLength() {
  13                 var cacheLength = 0;
  14                 for (var i in jQuery.cache) {
  15                         ++cacheLength;
  16                 }
  17
  18                 return cacheLength;
  19         }
  20
  21         equals( jQuery.data(elem, "foo"), undefined, "No data exists initially" );
  22         strictEqual( jQuery.hasData(elem), false, "jQuery.hasData agrees no data exists initially" );
  23
  24         var dataObj = jQuery.data(elem);
  25         equals( typeof dataObj, "object", "Calling data with no args gives us a data object reference" );
  26         strictEqual( jQuery.data(elem), dataObj, "Calling jQuery.data returns the same data object when called multiple times" );
  27
  28         strictEqual( jQuery.hasData(elem), false, "jQuery.hasData agrees no data exists even when an empty data obj exists" );
  29
  30         dataObj.foo = "bar";
  31         equals( jQuery.data(elem, "foo"), "bar", "Data is readable by jQuery.data when set directly on a returned data object" );
  32
  33         strictEqual( jQuery.hasData(elem), true, "jQuery.hasData agrees data exists when data exists" );
  34
  35         jQuery.data(elem, "foo", "baz");
  36         equals( jQuery.data(elem, "foo"), "baz", "Data can be changed by jQuery.data" );
  37         equals( dataObj.foo, "baz", "Changes made through jQuery.data propagate to referenced data object" );
  38
  39         jQuery.data(elem, "foo", undefined);
  40         equals( jQuery.data(elem, "foo"), "baz", "Data is not unset by passing undefined to jQuery.data" );
  41
  42         jQuery.data(elem, "foo", null);
  43         strictEqual( jQuery.data(elem, "foo"), null, "Setting null using jQuery.data works OK" );
  44
  45         jQuery.data(elem, "foo", "foo1");
  46
  47         jQuery.data(elem, { "bar" : "baz", "boom" : "bloz" });
  48         strictEqual( jQuery.data(elem, "foo"), "foo1", "Passing an object extends the data object instead of replacing it" );
  49         equals( jQuery.data(elem, "boom"), "bloz", "Extending the data object works" );
  50
  51         jQuery._data(elem, "foo", "foo2");
  52         equals( jQuery._data(elem, "foo"), "foo2", "Setting internal data works" );
  53         equals( jQuery.data(elem, "foo"), "foo1", "Setting internal data does not override user data" );
  54
  55         var internalDataObj = jQuery.data(elem, jQuery.expando);
  56         strictEqual( jQuery._data(elem), internalDataObj, "Internal data object is accessible via jQuery.expando property" );
  57         notStrictEqual( dataObj, internalDataObj, "Internal data object is not the same as user data object" );
  58
  59         strictEqual( elem.boom, undefined, "Data is never stored directly on the object" );
  60
  61         jQuery.removeData(elem, "foo");
  62         strictEqual( jQuery.data(elem, "foo"), undefined, "jQuery.removeData removes single properties" );
  63
  64         jQuery.removeData(elem);
  65         strictEqual( jQuery.data(elem, jQuery.expando), internalDataObj, "jQuery.removeData does not remove internal data if it exists" );
  66
  67         jQuery.removeData(elem, undefined, true);
  68
  69         strictEqual( jQuery.data(elem, jQuery.expando), undefined, "jQuery.removeData on internal data works" );
  70         strictEqual( jQuery.hasData(elem), false, "jQuery.hasData agrees all data has been removed from object" );
  71
  72         jQuery._data(elem, "foo", "foo2");
  73         strictEqual( jQuery.hasData(elem), true, "jQuery.hasData shows data exists even if it is only internal data" );
  74
  75         jQuery.data(elem, "foo", "foo1");
  76         equals( jQuery._data(elem, "foo"), "foo2", "Setting user data does not override internal data" );
  77
  78         jQuery.removeData(elem, undefined, true);
  79         equals( jQuery.data(elem, "foo"), "foo1", "jQuery.removeData for internal data does not remove user data" );
  80
  81         if (elem.nodeType) {
  82                 var oldCacheLength = getCacheLength();
  83                 jQuery.removeData(elem, "foo");
  84
  85                 equals( getCacheLength(), oldCacheLength - 1, "Removing the last item in the data object destroys it" );
  86         }
  87         else {
  88                 jQuery.removeData(elem, "foo");
  89                 var expected, actual;
  90
  91                 if (jQuery.support.deleteExpando) {
  92                         expected = false;
  93                         actual = jQuery.expando in elem;
  94                 }
  95                 else {
  96                         expected = null;
  97                         actual = elem[ jQuery.expando ];
  98                 }
  99
 100                 equals( actual, expected, "Removing the last item in the data object destroys it" );
 101         }
 102
 103         jQuery.data(elem, "foo", "foo1");
 104         jQuery._data(elem, "foo", "foo2");
 105
 106         equals( jQuery.data(elem, "foo"), "foo1", "(sanity check) Ensure data is set in user data object" );
 107         equals( jQuery._data(elem, "foo"), "foo2", "(sanity check) Ensure data is set in internal data object" );
 108
 109         jQuery.removeData(elem, "foo", true);
 110
 111         strictEqual( jQuery.data(elem, jQuery.expando), undefined, "Removing the last item in internal data destroys the internal data object" );
 112
 113         jQuery._data(elem, "foo", "foo2");
 114         equals( jQuery._data(elem, "foo"), "foo2", "(sanity check) Ensure data is set in internal data object" );
 115
 116         jQuery.removeData(elem, "foo");
 117         equals( jQuery._data(elem, "foo"), "foo2", "(sanity check) jQuery.removeData for user data does not remove internal data" );
 118
 119         if (elem.nodeType) {
 120                 oldCacheLength = getCacheLength();
 121                 jQuery.removeData(elem, "foo", true);
 122                 equals( getCacheLength(), oldCacheLength - 1, "Removing the last item in the internal data object also destroys the user data object when it is empty" );
 123         }
 124         else {
 125                 jQuery.removeData(elem, "foo", true);
 126
 127                 if (jQuery.support.deleteExpando) {
 128                         expected = false;
 129                         actual = jQuery.expando in elem;
 130                 }
 131                 else {
 132                         expected = null;
 133                         actual = elem[ jQuery.expando ];
 134                 }
 135
 136                 equals( actual, expected, "Removing the last item in the internal data object also destroys the user data object when it is empty" );
 137         }
 138 }
 139
 140 test("jQuery.data", function() {
 141         expect(128);
 142
 143         var div = document.createElement("div");
 144
 145         dataTests(div);
 146         dataTests({});
 147
 148         // remove bound handlers from window object to stop potential false positives caused by fix for #5280 in
 149         // transports/xhr.js
 150         jQuery(window).unbind("unload");
 151
 152         dataTests(window);
 153         dataTests(document);
 154
 155         // clean up unattached element
 156         jQuery(div).remove();
 157 });
 158
 159 test("jQuery.acceptData", function() {
 160         expect(7);
 161
 162         ok( jQuery.acceptData( document ), "document" );
 163         ok( jQuery.acceptData( document.documentElement ), "documentElement" );
 164         ok( jQuery.acceptData( {} ), "object" );
 165         ok( !jQuery.acceptData( document.createElement("embed") ), "embed" );
 166         ok( !jQuery.acceptData( document.createElement("applet") ), "applet" );
 167
 168         var flash = document.createElement("object");
 169         flash.setAttribute("classid", "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000");
 170         ok( jQuery.acceptData( flash ), "flash" );
 171
 172         var applet = document.createElement("object");
 173         applet.setAttribute("classid", "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93");
 174         ok( !jQuery.acceptData( applet ), "applet" );
 175 });
 176
 177 test(".data()", function() {
 178         expect(5);
 179
 180         var div = jQuery("#foo");
 181         strictEqual( div.data("foo"), undefined, "Make sure that missing result is undefined" );
 182         div.data("test", "success");
 183         same( div.data(), {test: "success"}, "data() get the entire data object" );
 184         strictEqual( div.data("foo"), undefined, "Make sure that missing result is still undefined" );
 185
 186         var nodiv = jQuery("#unfound");
 187         equals( nodiv.data(), null, "data() on empty set returns null" );
 188
 189         var obj = { foo: "bar" };
 190         jQuery(obj).data("foo", "baz");
 191
 192         var dataObj = jQuery.extend(true, {}, jQuery(obj).data());
 193
 194         deepEqual( dataObj, { foo: "baz" }, "Retrieve data object from a wrapped JS object (#7524)" );
 195 });
 196
 197 test(".data(String) and .data(String, Object)", function() {
 198         expect(29);
 199         var parent = jQuery("<div><div></div></div>"),
 200                 div = parent.children();
 201
 202         parent
 203                 .bind("getData", function(){ ok( false, "getData bubbled." ) })
 204                 .bind("setData", function(){ ok( false, "setData bubbled." ) })
 205                 .bind("changeData", function(){ ok( false, "changeData bubbled." ) });
 206
 207         ok( div.data("test") === undefined, "Check for no data exists" );
 208
 209         div.data("test", "success");
 210         equals( div.data("test"), "success", "Check for added data" );
 211
 212         div.data("test", "overwritten");
 213         equals( div.data("test"), "overwritten", "Check for overwritten data" );
 214
 215         div.data("test", undefined);
 216         equals( div.data("test"), "overwritten", "Check that data wasn't removed");
 217
 218         div.data("test", null);
 219         ok( div.data("test") === null, "Check for null data");
 220
 221         ok( div.data("notexist") === undefined, "Check for no data exists" );
 222
 223         div.data("test", "overwritten");
 224         var hits = {test:0}, gets = {test:0}, changes = {test:0, value:null};
 225
 226
 227         function logChangeData(e,key,value) {
 228                 var dataKey = key;
 229                 if ( e.namespace ) {
 230                         dataKey = dataKey + "." + e.namespace;
 231                 }
 232                 changes[key] += value;
 233                 changes.value = jQuery.data(e.target, dataKey);
 234         }
 235
 236         div
 237                 .bind("setData",function(e,key,value){ hits[key] += value; })
 238                 .bind("setData.foo",function(e,key,value){ hits[key] += value; })
 239                 .bind("changeData",logChangeData)
 240                 .bind("changeData.foo",logChangeData)
 241                 .bind("getData",function(e,key){ gets[key] += 1; })
 242                 .bind("getData.foo",function(e,key){ gets[key] += 3; });
 243
 244         div.data("test.foo", 2);
 245         equals( div.data("test"), "overwritten", "Check for original data" );
 246         equals( div.data("test.foo"), 2, "Check for namespaced data" );
 247         equals( div.data("test.bar"), "overwritten", "Check for unmatched namespace" );
 248         equals( hits.test, 2, "Check triggered setter functions" );
 249         equals( gets.test, 5, "Check triggered getter functions" );
 250         equals( changes.test, 2, "Check sets raise changeData");
 251         equals( changes.value, 2, "Check changeData after data has been set" );
 252
 253         hits.test = 0;
 254         gets.test = 0;
 255         changes.test = 0;
 256         changes.value = null;
 257
 258         div.data("test", 1);
 259         equals( div.data("test"), 1, "Check for original data" );
 260         equals( div.data("test.foo"), 2, "Check for namespaced data" );
 261         equals( div.data("test.bar"), 1, "Check for unmatched namespace" );
 262         equals( hits.test, 1, "Check triggered setter functions" );
 263         equals( gets.test, 5, "Check triggered getter functions" );
 264         equals( changes.test, 1, "Check sets raise changeData" );
 265         equals( changes.value, 1, "Check changeData after data has been set" );
 266
 267         div
 268                 .bind("getData",function(e,key){ return key + "root"; })
 269                 .bind("getData.foo",function(e,key){ return key + "foo"; });
 270
 271         equals( div.data("test"), "testroot", "Check for original data" );
 272         equals( div.data("test.foo"), "testfoo", "Check for namespaced data" );
 273         equals( div.data("test.bar"), "testroot", "Check for unmatched namespace" );
 274
 275         // #3748
 276         var $elem = jQuery({exists:true});
 277         equals( $elem.data('nothing'), undefined, "Non-existent data returns undefined");
 278         equals( $elem.data('null',null).data('null'), null, "null's are preserved");
 279         equals( $elem.data('emptyString','').data('emptyString'), '', "Empty strings are preserved");
 280         equals( $elem.data('false',false).data('false'), false, "false's are preserved");
 281         equals( $elem.data('exists'), undefined, "Existing data is not returned" );
 282
 283         // Clean up
 284         $elem.removeData();
 285         deepEqual( $elem[0], {exists:true}, "removeData does not clear the object" );
 286
 287         // manually clean up detached elements
 288         parent.remove();
 289 });
 290
 291 test("data-* attributes", function() {
 292         expect(37);
 293         var div = jQuery("<div>"),
 294                 child = jQuery("<div data-myobj='old data' data-ignored=\"DOM\" data-other='test'></div>"),
 295                 dummy = jQuery("<div data-myobj='old data' data-ignored=\"DOM\" data-other='test'></div>");
 296
 297         equals( div.data("attr"), undefined, "Check for non-existing data-attr attribute" );
 298
 299         div.attr("data-attr", "exists");
 300         equals( div.data("attr"), "exists", "Check for existing data-attr attribute" );
 301
 302         div.attr("data-attr", "exists2");
 303         equals( div.data("attr"), "exists", "Check that updates to data- don't update .data()" );
 304
 305         div.data("attr", "internal").attr("data-attr", "external");
 306         equals( div.data("attr"), "internal", "Check for .data('attr') precedence (internal > external data-* attribute)" );
 307
 308         div.remove();
 309
 310         child.appendTo('#main');
 311         equals( child.data("myobj"), "old data", "Value accessed from data-* attribute");
 312
 313         child.data("myobj", "replaced");
 314         equals( child.data("myobj"), "replaced", "Original data overwritten");
 315
 316         child.data("ignored", "cache");
 317         equals( child.data("ignored"), "cache", "Cached data used before DOM data-* fallback");
 318
 319         var obj = child.data(), obj2 = dummy.data(), check = [ "myobj", "ignored", "other" ], num = 0, num2 = 0;
 320
 321         dummy.remove();
 322
 323         for ( var i = 0, l = check.length; i < l; i++ ) {
 324                 ok( obj[ check[i] ], "Make sure data- property exists when calling data-." );
 325                 ok( obj2[ check[i] ], "Make sure data- property exists when calling data-." );
 326         }
 327
 328         for ( var prop in obj ) {
 329                 num++;
 330         }
 331
 332         equals( num, check.length, "Make sure that the right number of properties came through." );
 333
 334         for ( var prop in obj2 ) {
 335                 num2++;
 336         }
 337
 338         equals( num2, check.length, "Make sure that the right number of properties came through." );
 339
 340         child.attr("data-other", "newvalue");
 341
 342         equals( child.data("other"), "test", "Make sure value was pulled in properly from a .data()." );
 343
 344         child
 345                 .attr("data-true", "true")
 346                 .attr("data-false", "false")
 347                 .attr("data-five", "5")
 348                 .attr("data-point", "5.5")
 349                 .attr("data-pointe", "5.5E3")
 350                 .attr("data-pointbad", "5..5")
 351                 .attr("data-pointbad2", "-.")
 352                 .attr("data-badjson", "{123}")
 353                 .attr("data-badjson2", "[abc]")
 354                 .attr("data-empty", "")
 355                 .attr("data-space", " ")
 356                 .attr("data-null", "null")
 357                 .attr("data-string", "test");
 358
 359         strictEqual( child.data('true'), true, "Primitive true read from attribute");
 360         strictEqual( child.data('false'), false, "Primitive false read from attribute");
 361         strictEqual( child.data('five'), 5, "Primitive number read from attribute");
 362         strictEqual( child.data('point'), 5.5, "Primitive number read from attribute");
 363         strictEqual( child.data('pointe'), 5500, "Primitive number read from attribute");
 364         strictEqual( child.data('pointbad'), "5..5", "Bad number read from attribute");
 365         strictEqual( child.data('pointbad2'), "-.", "Bad number read from attribute");
 366         strictEqual( child.data('badjson'), "{123}", "Bad number read from attribute");
 367         strictEqual( child.data('badjson2'), "[abc]", "Bad number read from attribute");
 368         strictEqual( child.data('empty'), "", "Empty string read from attribute");
 369         strictEqual( child.data('space'), " ", "Empty string read from attribute");
 370         strictEqual( child.data('null'), null, "Primitive null read from attribute");
 371         strictEqual( child.data('string'), "test", "Typical string read from attribute");
 372
 373         child.remove();
 374
 375         // tests from metadata plugin
 376         function testData(index, elem) {
 377                 switch (index) {
 378                 case 0:
 379                         equals(jQuery(elem).data("foo"), "bar", "Check foo property");
 380                         equals(jQuery(elem).data("bar"), "baz", "Check baz property");
 381                         break;
 382                 case 1:
 383                         equals(jQuery(elem).data("test"), "bar", "Check test property");
 384                         equals(jQuery(elem).data("bar"), "baz", "Check bar property");
 385                         break;
 386                 case 2:
 387                         equals(jQuery(elem).data("zoooo"), "bar", "Check zoooo property");
 388                         same(jQuery(elem).data("bar"), {"test":"baz"}, "Check bar property");
 389                         break;
 390                 case 3:
 391                         equals(jQuery(elem).data("number"), true, "Check number property");
 392                         same(jQuery(elem).data("stuff"), [2,8], "Check stuff property");
 393                         break;
 394                 default:
 395                         ok(false, ["Assertion failed on index ", index, ", with data ", data].join(''));
 396                 }
 397         }
 398
 399         var metadata = '<ol><li class="test test2" data-foo="bar" data-bar="baz" data-arr="[1,2]">Some stuff</li><li class="test test2" data-test="bar" data-bar="baz">Some stuff</li><li class="test test2" data-zoooo="bar" data-bar=\'{"test":"baz"}\'>Some stuff</li><li class="test test2" data-number=true data-stuff="[2,8]">Some stuff</li></ol>',
 400                 elem = jQuery(metadata).appendTo('#main');
 401
 402         elem.find("li").each(testData);
 403         elem.remove();
 404 });
 405
 406 test(".data(Object)", function() {
 407         expect(4);
 408
 409         var div = jQuery("<div/>");
 410
 411         div.data({ "test": "in", "test2": "in2" });
 412         equals( div.data("test"), "in", "Verify setting an object in data" );
 413         equals( div.data("test2"), "in2", "Verify setting an object in data" );
 414
 415         var obj = {test:"unset"},
 416                 jqobj = jQuery(obj);
 417         jqobj.data("test", "unset");
 418         jqobj.data({ "test": "in", "test2": "in2" });
 419         equals( jQuery.data(obj).test, "in", "Verify setting an object on an object extends the data object" );
 420         equals( obj.test2, undefined, "Verify setting an object on an object does not extend the object" );
 421
 422         // manually clean up detached elements
 423         div.remove();
 424 });
 425
 426 test("jQuery.removeData", function() {
 427         expect(6);
 428         var div = jQuery("#foo")[0];
 429         jQuery.data(div, "test", "testing");
 430         jQuery.removeData(div, "test");
 431         equals( jQuery.data(div, "test"), undefined, "Check removal of data" );
 432
 433         jQuery.data(div, "test2", "testing");
 434         jQuery.removeData( div );
 435         ok( !jQuery.data(div, "test2"), "Make sure that the data property no longer exists." );
 436         ok( !div[ jQuery.expando ], "Make sure the expando no longer exists, as well." );
 437
 438         var obj = {};
 439         jQuery.data(obj, "test", "testing");
 440         equals( jQuery(obj).data("test"), "testing", "verify data on plain object");
 441         jQuery.removeData(obj, "test");
 442         equals( jQuery.data(obj, "test"), undefined, "Check removal of data on plain object" );
 443
 444         jQuery.data( window, "BAD", true );
 445         jQuery.removeData( window, "BAD" );
 446         ok( !jQuery.data( window, "BAD" ), "Make sure that the value was not still set." );
 447 });
 448
 449 test(".removeData()", function() {
 450         expect(6);
 451         var div = jQuery("#foo");
 452         div.data("test", "testing");
 453         div.removeData("test");
 454         equals( div.data("test"), undefined, "Check removal of data" );
 455
 456         div.data("test", "testing");
 457         div.data("test.foo", "testing2");
 458         div.removeData("test.bar");
 459         equals( div.data("test.foo"), "testing2", "Make sure data is intact" );
 460         equals( div.data("test"), "testing", "Make sure data is intact" );
 461
 462         div.removeData("test");
 463         equals( div.data("test.foo"), "testing2", "Make sure data is intact" );
 464         equals( div.data("test"), undefined, "Make sure data is intact" );
 465
 466         div.removeData("test.foo");
 467         equals( div.data("test.foo"), undefined, "Make sure data is intact" );
 468 });