Merge branch 'master' of https://github.com/mathiasbynens/jquery into mathiasbynens...
[jquery.git] / 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         deepEqual( jQuery(obj).data(), {}, "Retrieve data object from a wrapped JS object (#7524)" );
191 })
192
193 test(".data(String) and .data(String, Object)", function() {
194         expect(29);
195         var parent = jQuery("<div><div></div></div>"),
196                 div = parent.children();
197
198         parent
199                 .bind("getData", function(){ ok( false, "getData bubbled." ) })
200                 .bind("setData", function(){ ok( false, "setData bubbled." ) })
201                 .bind("changeData", function(){ ok( false, "changeData bubbled." ) });
202
203         ok( div.data("test") === undefined, "Check for no data exists" );
204
205         div.data("test", "success");
206         equals( div.data("test"), "success", "Check for added data" );
207
208         div.data("test", "overwritten");
209         equals( div.data("test"), "overwritten", "Check for overwritten data" );
210
211         div.data("test", undefined);
212         equals( div.data("test"), "overwritten", "Check that data wasn't removed");
213
214         div.data("test", null);
215         ok( div.data("test") === null, "Check for null data");
216
217         ok( div.data("notexist") === undefined, "Check for no data exists" );
218
219         div.data("test", "overwritten");
220         var hits = {test:0}, gets = {test:0}, changes = {test:0, value:null};
221
222
223         function logChangeData(e,key,value) {
224                 var dataKey = key;
225                 if ( e.namespace ) {
226                         dataKey = dataKey + "." + e.namespace;
227                 }
228                 changes[key] += value;
229                 changes.value = jQuery.data(e.target, dataKey);
230         }
231
232         div
233                 .bind("setData",function(e,key,value){ hits[key] += value; })
234                 .bind("setData.foo",function(e,key,value){ hits[key] += value; })
235                 .bind("changeData",logChangeData)
236                 .bind("changeData.foo",logChangeData)
237                 .bind("getData",function(e,key){ gets[key] += 1; })
238                 .bind("getData.foo",function(e,key){ gets[key] += 3; });
239
240         div.data("test.foo", 2);
241         equals( div.data("test"), "overwritten", "Check for original data" );
242         equals( div.data("test.foo"), 2, "Check for namespaced data" );
243         equals( div.data("test.bar"), "overwritten", "Check for unmatched namespace" );
244         equals( hits.test, 2, "Check triggered setter functions" );
245         equals( gets.test, 5, "Check triggered getter functions" );
246         equals( changes.test, 2, "Check sets raise changeData");
247         equals( changes.value, 2, "Check changeData after data has been set" );
248
249         hits.test = 0;
250         gets.test = 0;
251         changes.test = 0;
252         changes.value = null;
253
254         div.data("test", 1);
255         equals( div.data("test"), 1, "Check for original data" );
256         equals( div.data("test.foo"), 2, "Check for namespaced data" );
257         equals( div.data("test.bar"), 1, "Check for unmatched namespace" );
258         equals( hits.test, 1, "Check triggered setter functions" );
259         equals( gets.test, 5, "Check triggered getter functions" );
260         equals( changes.test, 1, "Check sets raise changeData" );
261         equals( changes.value, 1, "Check changeData after data has been set" );
262
263         div
264                 .bind("getData",function(e,key){ return key + "root"; })
265                 .bind("getData.foo",function(e,key){ return key + "foo"; });
266
267         equals( div.data("test"), "testroot", "Check for original data" );
268         equals( div.data("test.foo"), "testfoo", "Check for namespaced data" );
269         equals( div.data("test.bar"), "testroot", "Check for unmatched namespace" );
270
271         // #3748
272         var $elem = jQuery({exists:true});
273         equals( $elem.data('nothing'), undefined, "Non-existent data returns undefined");
274         equals( $elem.data('null',null).data('null'), null, "null's are preserved");
275         equals( $elem.data('emptyString','').data('emptyString'), '', "Empty strings are preserved");
276         equals( $elem.data('false',false).data('false'), false, "false's are preserved");
277         equals( $elem.data('exists'), undefined, "Existing data is not returned" );
278
279         // Clean up
280         $elem.removeData();
281         deepEqual( $elem[0], {exists:true}, "removeData does not clear the object" );
282
283         // manually clean up detached elements
284         parent.remove();
285 });
286
287 test("data-* attributes", function() {
288         expect(37);
289         var div = jQuery("<div>"),
290                 child = jQuery("<div data-myobj='old data' data-ignored=\"DOM\" data-other='test'></div>"),
291                 dummy = jQuery("<div data-myobj='old data' data-ignored=\"DOM\" data-other='test'></div>");
292
293         equals( div.data("attr"), undefined, "Check for non-existing data-attr attribute" );
294
295         div.attr("data-attr", "exists");
296         equals( div.data("attr"), "exists", "Check for existing data-attr attribute" );
297
298         div.attr("data-attr", "exists2");
299         equals( div.data("attr"), "exists", "Check that updates to data- don't update .data()" );
300
301         div.data("attr", "internal").attr("data-attr", "external");
302         equals( div.data("attr"), "internal", "Check for .data('attr') precedence (internal > external data-* attribute)" );
303
304         div.remove();
305
306         child.appendTo('#main');
307         equals( child.data("myobj"), "old data", "Value accessed from data-* attribute");
308
309         child.data("myobj", "replaced");
310         equals( child.data("myobj"), "replaced", "Original data overwritten");
311
312         child.data("ignored", "cache");
313         equals( child.data("ignored"), "cache", "Cached data used before DOM data-* fallback");
314
315         var obj = child.data(), obj2 = dummy.data(), check = [ "myobj", "ignored", "other" ], num = 0, num2 = 0;
316
317         dummy.remove();
318
319         for ( var i = 0, l = check.length; i < l; i++ ) {
320                 ok( obj[ check[i] ], "Make sure data- property exists when calling data-." );
321                 ok( obj2[ check[i] ], "Make sure data- property exists when calling data-." );
322         }
323
324         for ( var prop in obj ) {
325                 num++;
326         }
327
328         equals( num, check.length, "Make sure that the right number of properties came through." );
329
330         for ( var prop in obj2 ) {
331                 num2++;
332         }
333
334         equals( num2, check.length, "Make sure that the right number of properties came through." );
335
336         child.attr("data-other", "newvalue");
337
338         equals( child.data("other"), "test", "Make sure value was pulled in properly from a .data()." );
339
340         child
341                 .attr("data-true", "true")
342                 .attr("data-false", "false")
343                 .attr("data-five", "5")
344                 .attr("data-point", "5.5")
345                 .attr("data-pointe", "5.5E3")
346                 .attr("data-pointbad", "5..5")
347                 .attr("data-pointbad2", "-.")
348                 .attr("data-badjson", "{123}")
349                 .attr("data-badjson2", "[abc]")
350                 .attr("data-empty", "")
351                 .attr("data-space", " ")
352                 .attr("data-null", "null")
353                 .attr("data-string", "test");
354
355         strictEqual( child.data('true'), true, "Primitive true read from attribute");
356         strictEqual( child.data('false'), false, "Primitive false read from attribute");
357         strictEqual( child.data('five'), 5, "Primitive number read from attribute");
358         strictEqual( child.data('point'), 5.5, "Primitive number read from attribute");
359         strictEqual( child.data('pointe'), 5500, "Primitive number read from attribute");
360         strictEqual( child.data('pointbad'), "5..5", "Bad number read from attribute");
361         strictEqual( child.data('pointbad2'), "-.", "Bad number read from attribute");
362         strictEqual( child.data('badjson'), "{123}", "Bad number read from attribute");
363         strictEqual( child.data('badjson2'), "[abc]", "Bad number read from attribute");
364         strictEqual( child.data('empty'), "", "Empty string read from attribute");
365         strictEqual( child.data('space'), " ", "Empty string read from attribute");
366         strictEqual( child.data('null'), null, "Primitive null read from attribute");
367         strictEqual( child.data('string'), "test", "Typical string read from attribute");
368
369         child.remove();
370
371         // tests from metadata plugin
372         function testData(index, elem) {
373                 switch (index) {
374                 case 0:
375                         equals(jQuery(elem).data("foo"), "bar", "Check foo property");
376                         equals(jQuery(elem).data("bar"), "baz", "Check baz property");
377                         break;
378                 case 1:
379                         equals(jQuery(elem).data("test"), "bar", "Check test property");
380                         equals(jQuery(elem).data("bar"), "baz", "Check bar property");
381                         break;
382                 case 2:
383                         equals(jQuery(elem).data("zoooo"), "bar", "Check zoooo property");
384                         same(jQuery(elem).data("bar"), {"test":"baz"}, "Check bar property");
385                         break;
386                 case 3:
387                         equals(jQuery(elem).data("number"), true, "Check number property");
388                         same(jQuery(elem).data("stuff"), [2,8], "Check stuff property");
389                         break;
390                 default:
391                         ok(false, ["Assertion failed on index ", index, ", with data ", data].join(''));
392                 }
393         }
394
395         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>',
396                 elem = jQuery(metadata).appendTo('#main');
397
398         elem.find("li").each(testData);
399         elem.remove();
400 });
401
402 test(".data(Object)", function() {
403         expect(4);
404
405         var div = jQuery("<div/>");
406
407         div.data({ "test": "in", "test2": "in2" });
408         equals( div.data("test"), "in", "Verify setting an object in data" );
409         equals( div.data("test2"), "in2", "Verify setting an object in data" );
410
411         var obj = {test:"unset"},
412                 jqobj = jQuery(obj);
413         jqobj.data("test", "unset");
414         jqobj.data({ "test": "in", "test2": "in2" });
415         equals( jQuery.data(obj).test, "in", "Verify setting an object on an object extends the data object" );
416         equals( obj.test2, undefined, "Verify setting an object on an object does not extend the object" );
417
418         // manually clean up detached elements
419         div.remove();
420 });
421
422 test("jQuery.removeData", function() {
423         expect(6);
424         var div = jQuery("#foo")[0];
425         jQuery.data(div, "test", "testing");
426         jQuery.removeData(div, "test");
427         equals( jQuery.data(div, "test"), undefined, "Check removal of data" );
428
429         jQuery.data(div, "test2", "testing");
430         jQuery.removeData( div );
431         ok( !jQuery.data(div, "test2"), "Make sure that the data property no longer exists." );
432         ok( !div[ jQuery.expando ], "Make sure the expando no longer exists, as well." );
433
434         var obj = {};
435         jQuery.data(obj, "test", "testing");
436         equals( jQuery(obj).data("test"), "testing", "verify data on plain object");
437         jQuery.removeData(obj, "test");
438         equals( jQuery.data(obj, "test"), undefined, "Check removal of data on plain object" );
439
440         jQuery.data( window, "BAD", true );
441         jQuery.removeData( window, "BAD" );
442         ok( !jQuery.data( window, "BAD" ), "Make sure that the value was not still set." );
443 });
444
445 test(".removeData()", function() {
446         expect(6);
447         var div = jQuery("#foo");
448         div.data("test", "testing");
449         div.removeData("test");
450         equals( div.data("test"), undefined, "Check removal of data" );
451
452         div.data("test", "testing");
453         div.data("test.foo", "testing2");
454         div.removeData("test.bar");
455         equals( div.data("test.foo"), "testing2", "Make sure data is intact" );
456         equals( div.data("test"), "testing", "Make sure data is intact" );
457
458         div.removeData("test");
459         equals( div.data("test.foo"), "testing2", "Make sure data is intact" );
460         equals( div.data("test"), undefined, "Make sure data is intact" );
461
462         div.removeData("test.foo");
463         equals( div.data("test.foo"), undefined, "Make sure data is intact" );
464 });