Update jQuery.hasData to always return a boolean, with unit tests.
[jquery.git] / test / unit / data.js
1 module("data");
2
3 test("expando", function(){
4         expect(6);
5
6         equals("expando" in jQuery, true, "jQuery is exposing the expando");
7
8         var obj = {};
9         equals( jQuery.data(obj), obj, "jQuery.data(obj) returns the object");
10         equals( jQuery.expando in obj, false, "jQuery.data(obj) did not add an expando to the object" );
11
12         obj = {};
13         jQuery.data(obj, 'test');
14         equals( jQuery.expando in obj, false, "jQuery.data(obj,key) did not add an expando to the object" );
15
16         obj = {};
17         jQuery.data(obj, "foo", "bar");
18         equals( jQuery.expando in obj, false, "jQuery.data(obj,key,value) did not add an expando to the object" );
19         equals( obj.foo, "bar", "jQuery.data(obj,key,value) sets fields directly on the object." );
20 });
21
22 test("jQuery.acceptData", function() {
23         expect(7);
24
25         ok( jQuery.acceptData( document ), "document" );
26         ok( jQuery.acceptData( document.documentElement ), "documentElement" );
27         ok( jQuery.acceptData( {} ), "object" );
28         ok( !jQuery.acceptData( document.createElement("embed") ), "embed" );
29         ok( !jQuery.acceptData( document.createElement("applet") ), "applet" );
30
31         var flash = document.createElement("object");
32         flash.setAttribute("classid", "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000");
33         ok( jQuery.acceptData( flash ), "flash" );
34
35         var applet = document.createElement("object");
36         applet.setAttribute("classid", "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93");
37         ok( !jQuery.acceptData( applet ), "applet" );
38 });
39
40 test("jQuery.data", function() {
41         expect(15);
42         var div = document.createElement("div");
43
44         ok( jQuery.data(div, "test") === undefined, "Check for no data exists" );
45
46         jQuery.data(div, "test", "success");
47         equals( jQuery.data(div, "test"), "success", "Check for added data" );
48
49         ok( jQuery.data(div, "notexist") === undefined, "Check for no data exists" );
50
51         var data = jQuery.data(div);
52         same( data, { "test": "success" }, "Return complete data set" );
53
54         jQuery.data(div, "test", "overwritten");
55         equals( jQuery.data(div, "test"), "overwritten", "Check for overwritten data" );
56
57         jQuery.data(div, "test", undefined);
58         equals( jQuery.data(div, "test"), "overwritten", "Check that data wasn't removed");
59
60         jQuery.data(div, "test", null);
61         ok( jQuery.data(div, "test") === null, "Check for null data");
62
63         jQuery.data(div, "test3", "orig");
64         jQuery.data(div, { "test": "in", "test2": "in2" });
65         equals( jQuery.data(div, "test"), "in", "Verify setting an object in data" );
66         equals( jQuery.data(div, "test2"), "in2", "Verify setting an object in data" );
67         equals( jQuery.data(div, "test3"), "orig", "Verify original not overwritten" );
68
69         var obj = {};
70         jQuery.data( obj, "prop", true );
71
72         ok( obj.prop, "Data is being stored on the object" );
73         equals( jQuery.data( obj, "prop" ), true, "Make sure the right value is retrieved" );
74
75         jQuery.data( window, "BAD", true );
76         ok( !window[ jQuery.expando ], "Make sure there is no expando on the window object." );
77         ok( !window.BAD, "And make sure that the property wasn't set directly on the window." );
78         ok( jQuery.data( window, "BAD" ), "Make sure that the value was set." );
79 });
80
81 test("jQuery.hasData", function() {
82         var div = document.createElement( "div" );
83         equals( jQuery.hasData(div), false, "No data exists" );
84         jQuery.data( div, "foo", "bar" );
85         equals( jQuery.hasData(div), true, "Data exists" );
86         jQuery.removeData( div, "foo" );
87         equals( jQuery.hasData(div), false, "Data was removed" );
88 });
89
90 test(".data()", function() {
91         expect(5);
92
93         var div = jQuery("#foo");
94         strictEqual( div.data("foo"), undefined, "Make sure that missing result is undefined" );
95
96         div.data("test", "success");
97         same( div.data(), {test: "success"}, "data() get the entire data object" );
98         strictEqual( div.data("foo"), undefined, "Make sure that missing result is still undefined" );
99
100         var nodiv = jQuery("#unfound");
101         equals( nodiv.data(), null, "data() on empty set returns null" );
102
103         var obj = { foo: "bar" };
104         equals( jQuery(obj).data(), obj, "Retrieve data object from a wrapped JS object (#7524)" );
105 })
106
107 test(".data(String) and .data(String, Object)", function() {
108         expect(29);
109         var parent = jQuery("<div><div></div></div>"),
110                 div = parent.children();
111
112         parent
113                 .bind("getData", function(){ ok( false, "getData bubbled." ) })
114                 .bind("setData", function(){ ok( false, "setData bubbled." ) })
115                 .bind("changeData", function(){ ok( false, "changeData bubbled." ) });
116
117         ok( div.data("test") === undefined, "Check for no data exists" );
118
119         div.data("test", "success");
120         equals( div.data("test"), "success", "Check for added data" );
121
122         div.data("test", "overwritten");
123         equals( div.data("test"), "overwritten", "Check for overwritten data" );
124
125         div.data("test", undefined);
126         equals( div.data("test"), "overwritten", "Check that data wasn't removed");
127
128         div.data("test", null);
129         ok( div.data("test") === null, "Check for null data");
130
131         ok( div.data("notexist") === undefined, "Check for no data exists" );
132
133         div.data("test", "overwritten");
134         var hits = {test:0}, gets = {test:0}, changes = {test:0, value:null};
135
136
137         function logChangeData(e,key,value) {
138                 var dataKey = key;
139                 if ( e.namespace ) {
140                         dataKey = dataKey + "." + e.namespace;
141                 }
142                 changes[key] += value;
143                 changes.value = jQuery.data(e.target, dataKey);
144         }
145
146         div
147                 .bind("setData",function(e,key,value){ hits[key] += value; })
148                 .bind("setData.foo",function(e,key,value){ hits[key] += value; })
149                 .bind("changeData",logChangeData)
150                 .bind("changeData.foo",logChangeData)
151                 .bind("getData",function(e,key){ gets[key] += 1; })
152                 .bind("getData.foo",function(e,key){ gets[key] += 3; });
153
154         div.data("test.foo", 2);
155         equals( div.data("test"), "overwritten", "Check for original data" );
156         equals( div.data("test.foo"), 2, "Check for namespaced data" );
157         equals( div.data("test.bar"), "overwritten", "Check for unmatched namespace" );
158         equals( hits.test, 2, "Check triggered setter functions" );
159         equals( gets.test, 5, "Check triggered getter functions" );
160         equals( changes.test, 2, "Check sets raise changeData");
161         equals( changes.value, 2, "Check changeData after data has been set" );
162
163         hits.test = 0;
164         gets.test = 0;
165         changes.test = 0;
166         changes.value = null;
167
168         div.data("test", 1);
169         equals( div.data("test"), 1, "Check for original data" );
170         equals( div.data("test.foo"), 2, "Check for namespaced data" );
171         equals( div.data("test.bar"), 1, "Check for unmatched namespace" );
172         equals( hits.test, 1, "Check triggered setter functions" );
173         equals( gets.test, 5, "Check triggered getter functions" );
174         equals( changes.test, 1, "Check sets raise changeData" );
175         equals( changes.value, 1, "Check changeData after data has been set" );
176
177         div
178                 .bind("getData",function(e,key){ return key + "root"; })
179                 .bind("getData.foo",function(e,key){ return key + "foo"; });
180
181         equals( div.data("test"), "testroot", "Check for original data" );
182         equals( div.data("test.foo"), "testfoo", "Check for namespaced data" );
183         equals( div.data("test.bar"), "testroot", "Check for unmatched namespace" );
184
185         // #3748
186         var $elem = jQuery({exists:true});
187         equals( $elem.data('nothing'), undefined, "Non-existent data returns undefined");
188         equals( $elem.data('null',null).data('null'), null, "null's are preserved");
189         equals( $elem.data('emptyString','').data('emptyString'), '', "Empty strings are preserved");
190         equals( $elem.data('false',false).data('false'), false, "false's are preserved");
191         equals( $elem.data('exists'), true, "Existing data is returned" );
192
193         // Clean up
194         $elem.removeData();
195         ok( jQuery.isEmptyObject( $elem[0] ), "removeData clears the object" );
196 });
197
198 test("data-* attributes", function() {
199         expect(37);
200         var div = jQuery("<div>"),
201                 child = jQuery("<div data-myobj='old data' data-ignored=\"DOM\" data-other='test'></div>"),
202                 dummy = jQuery("<div data-myobj='old data' data-ignored=\"DOM\" data-other='test'></div>");
203
204         equals( div.data("attr"), undefined, "Check for non-existing data-attr attribute" );
205
206         div.attr("data-attr", "exists");
207         equals( div.data("attr"), "exists", "Check for existing data-attr attribute" );
208
209         div.attr("data-attr", "exists2");
210         equals( div.data("attr"), "exists", "Check that updates to data- don't update .data()" );
211
212         div.data("attr", "internal").attr("data-attr", "external");
213         equals( div.data("attr"), "internal", "Check for .data('attr') precedence (internal > external data-* attribute)" );
214
215         child.appendTo('#main');
216         equals( child.data("myobj"), "old data", "Value accessed from data-* attribute");
217
218         child.data("myobj", "replaced");
219         equals( child.data("myobj"), "replaced", "Original data overwritten");
220
221         child.data("ignored", "cache");
222         equals( child.data("ignored"), "cache", "Cached data used before DOM data-* fallback");
223
224         var obj = child.data(), obj2 = dummy.data(), check = [ "myobj", "ignored", "other" ], num = 0, num2 = 0;
225
226         for ( var i = 0, l = check.length; i < l; i++ ) {
227                 ok( obj[ check[i] ], "Make sure data- property exists when calling data-." );
228                 ok( obj2[ check[i] ], "Make sure data- property exists when calling data-." );
229         }
230
231         for ( var prop in obj ) {
232                 num++;
233         }
234
235         equals( num, check.length, "Make sure that the right number of properties came through." );
236
237         for ( var prop in obj2 ) {
238                 num2++;
239         }
240
241         equals( num2, check.length, "Make sure that the right number of properties came through." );
242
243         child.attr("data-other", "newvalue");
244
245         equals( child.data("other"), "test", "Make sure value was pulled in properly from a .data()." );
246
247         child
248                 .attr("data-true", "true")
249                 .attr("data-false", "false")
250                 .attr("data-five", "5")
251                 .attr("data-point", "5.5")
252                 .attr("data-pointe", "5.5E3")
253                 .attr("data-pointbad", "5..5")
254                 .attr("data-pointbad2", "-.")
255                 .attr("data-badjson", "{123}")
256                 .attr("data-badjson2", "[abc]")
257                 .attr("data-empty", "")
258                 .attr("data-space", " ")
259                 .attr("data-null", "null")
260                 .attr("data-string", "test");
261
262         strictEqual( child.data('true'), true, "Primitive true read from attribute");
263         strictEqual( child.data('false'), false, "Primitive false read from attribute");
264         strictEqual( child.data('five'), 5, "Primitive number read from attribute");
265         strictEqual( child.data('point'), 5.5, "Primitive number read from attribute");
266         strictEqual( child.data('pointe'), 5500, "Primitive number read from attribute");
267         strictEqual( child.data('pointbad'), "5..5", "Bad number read from attribute");
268         strictEqual( child.data('pointbad2'), "-.", "Bad number read from attribute");
269         strictEqual( child.data('badjson'), "{123}", "Bad number read from attribute");
270         strictEqual( child.data('badjson2'), "[abc]", "Bad number read from attribute");
271         strictEqual( child.data('empty'), "", "Empty string read from attribute");
272         strictEqual( child.data('space'), " ", "Empty string read from attribute");
273         strictEqual( child.data('null'), null, "Primitive null read from attribute");
274         strictEqual( child.data('string'), "test", "Typical string read from attribute");
275
276         child.remove();
277
278         // tests from metadata plugin
279         function testData(index, elem) {
280                 switch (index) {
281                 case 0:
282                         equals(jQuery(elem).data("foo"), "bar", "Check foo property");
283                         equals(jQuery(elem).data("bar"), "baz", "Check baz property");
284                         break;
285                 case 1:
286                         equals(jQuery(elem).data("test"), "bar", "Check test property");
287                         equals(jQuery(elem).data("bar"), "baz", "Check bar property");
288                         break;
289                 case 2:
290                         equals(jQuery(elem).data("zoooo"), "bar", "Check zoooo property");
291                         same(jQuery(elem).data("bar"), {"test":"baz"}, "Check bar property");
292                         break;
293                 case 3:
294                         equals(jQuery(elem).data("number"), true, "Check number property");
295                         same(jQuery(elem).data("stuff"), [2,8], "Check stuff property");
296                         break;
297                 default:
298                         ok(false, ["Assertion failed on index ", index, ", with data ", data].join(''));
299                 }
300         }
301
302         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>',
303                 elem = jQuery(metadata).appendTo('#main');
304
305         elem.find("li").each(testData);
306         elem.remove();
307 });
308
309 test(".data(Object)", function() {
310         expect(4);
311
312         var div = jQuery("<div/>");
313
314         div.data({ "test": "in", "test2": "in2" });
315         equals( div.data("test"), "in", "Verify setting an object in data" );
316         equals( div.data("test2"), "in2", "Verify setting an object in data" );
317
318         var obj = {test:"unset"},
319                 jqobj = jQuery(obj);
320         jqobj.data({ "test": "in", "test2": "in2" });
321         equals( obj.test, "in", "Verify setting an object on an object extends the object" );
322         equals( obj.test2, "in2", "Verify setting an object on an object extends the object" );
323 });
324
325 test("jQuery.removeData", function() {
326         expect(7);
327         var div = jQuery("#foo")[0];
328         jQuery.data(div, "test", "testing");
329         jQuery.removeData(div, "test");
330         equals( jQuery.data(div, "test"), undefined, "Check removal of data" );
331
332         jQuery.data(div, "test2", "testing");
333         jQuery.removeData( div );
334         ok( !jQuery.data(div, "test2"), "Make sure that the data property no longer exists." );
335         ok( !div[ jQuery.expando ], "Make sure the expando no longer exists, as well." );
336
337         var obj = {};
338         jQuery.data(obj, "test", "testing");
339         equals( obj.test, "testing", "verify data on plain object");
340         jQuery.removeData(obj, "test");
341         equals( jQuery.data(obj, "test"), undefined, "Check removal of data on plain object" );
342         equals( obj.test, undefined, "Check removal of data directly from plain object" );
343
344         jQuery.data( window, "BAD", true );
345         jQuery.removeData( window, "BAD" );
346         ok( !jQuery.data( window, "BAD" ), "Make sure that the value was not still set." );
347 });
348
349 test(".removeData()", function() {
350         expect(6);
351         var div = jQuery("#foo");
352         div.data("test", "testing");
353         div.removeData("test");
354         equals( div.data("test"), undefined, "Check removal of data" );
355
356         div.data("test", "testing");
357         div.data("test.foo", "testing2");
358         div.removeData("test.bar");
359         equals( div.data("test.foo"), "testing2", "Make sure data is intact" );
360         equals( div.data("test"), "testing", "Make sure data is intact" );
361
362         div.removeData("test");
363         equals( div.data("test.foo"), "testing2", "Make sure data is intact" );
364         equals( div.data("test"), undefined, "Make sure data is intact" );
365
366         div.removeData("test.foo");
367         equals( div.data("test.foo"), undefined, "Make sure data is intact" );
368 });