Using data() on JavaScript objects sets fields directly on the object. Note that...
[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(12);
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
76 test(".data()", function() {
77         expect(4);
78
79         var div = jQuery("#foo");
80         strictEqual( div.data("foo"), undefined, "Make sure that missing result is undefined" );
81
82         div.data("test", "success");
83         same( div.data(), {test: "success"}, "data() get the entire data object" );
84         strictEqual( div.data("foo"), undefined, "Make sure that missing result is still undefined" );
85
86         var nodiv = jQuery("#unfound");
87         equals( nodiv.data(), null, "data() on empty set returns null" );
88 })
89
90 test(".data(String) and .data(String, Object)", function() {
91         expect(29);
92         var parent = jQuery("<div><div></div></div>"),
93                 div = parent.children();
94
95         parent
96                 .bind("getData", function(){ ok( false, "getData bubbled." ) })
97                 .bind("setData", function(){ ok( false, "setData bubbled." ) })
98                 .bind("changeData", function(){ ok( false, "changeData bubbled." ) });
99
100         ok( div.data("test") === undefined, "Check for no data exists" );
101
102         div.data("test", "success");
103         equals( div.data("test"), "success", "Check for added data" );
104
105         div.data("test", "overwritten");
106         equals( div.data("test"), "overwritten", "Check for overwritten data" );
107
108         div.data("test", undefined);
109         equals( div.data("test"), "overwritten", "Check that data wasn't removed");
110
111         div.data("test", null);
112         ok( div.data("test") === null, "Check for null data");
113
114         ok( div.data("notexist") === undefined, "Check for no data exists" );
115
116         div.data("test", "overwritten");
117         var hits = {test:0}, gets = {test:0}, changes = {test:0, value:null};
118
119
120         function logChangeData(e,key,value) {
121                 var dataKey = key;
122                 if ( e.namespace ) {
123                         dataKey = dataKey + "." + e.namespace;
124                 }
125                 changes[key] += value;
126                 changes.value = jQuery.data(e.target, dataKey);
127         }
128
129         div
130                 .bind("setData",function(e,key,value){ hits[key] += value; })
131                 .bind("setData.foo",function(e,key,value){ hits[key] += value; })
132                 .bind("changeData",logChangeData)
133                 .bind("changeData.foo",logChangeData)
134                 .bind("getData",function(e,key){ gets[key] += 1; })
135                 .bind("getData.foo",function(e,key){ gets[key] += 3; });
136
137         div.data("test.foo", 2);
138         equals( div.data("test"), "overwritten", "Check for original data" );
139         equals( div.data("test.foo"), 2, "Check for namespaced data" );
140         equals( div.data("test.bar"), "overwritten", "Check for unmatched namespace" );
141         equals( hits.test, 2, "Check triggered setter functions" );
142         equals( gets.test, 5, "Check triggered getter functions" );
143         equals( changes.test, 2, "Check sets raise changeData");
144         equals( changes.value, 2, "Check changeData after data has been set" );
145
146         hits.test = 0;
147         gets.test = 0;
148         changes.test = 0;
149         changes.value = null;
150
151         div.data("test", 1);
152         equals( div.data("test"), 1, "Check for original data" );
153         equals( div.data("test.foo"), 2, "Check for namespaced data" );
154         equals( div.data("test.bar"), 1, "Check for unmatched namespace" );
155         equals( hits.test, 1, "Check triggered setter functions" );
156         equals( gets.test, 5, "Check triggered getter functions" );
157         equals( changes.test, 1, "Check sets raise changeData" );
158         equals( changes.value, 1, "Check changeData after data has been set" );
159
160         div
161                 .bind("getData",function(e,key){ return key + "root"; })
162                 .bind("getData.foo",function(e,key){ return key + "foo"; });
163
164         equals( div.data("test"), "testroot", "Check for original data" );
165         equals( div.data("test.foo"), "testfoo", "Check for namespaced data" );
166         equals( div.data("test.bar"), "testroot", "Check for unmatched namespace" );
167
168         // #3748
169         var $elem = jQuery({exists:true});
170         equals( $elem.data('nothing'), undefined, "Non-existent data returns undefined");
171         equals( $elem.data('null',null).data('null'), null, "null's are preserved");
172         equals( $elem.data('emptyString','').data('emptyString'), '', "Empty strings are preserved");
173         equals( $elem.data('false',false).data('false'), false, "false's are preserved");
174         equals( $elem.data('exists'), true, "Existing data is returned" );
175         
176         // Clean up
177         $elem.removeData();
178         ok( jQuery.isEmptyObject( $elem[0] ), "removeData clears the object" );
179 });
180
181 test("data-* attributes", function() {
182         expect(27);
183         var div = jQuery("<div>"),
184                 child = jQuery("<div data-myobj='old data' data-ignored=\"DOM\"></div>");
185                 
186         equals( div.data("attr"), undefined, "Check for non-existing data-attr attribute" );
187
188         div.attr("data-attr", "exists");
189         equals( div.data("attr"), "exists", "Check for existing data-attr attribute" );
190                 
191         div.data("attr", "internal").attr("data-attr", "external");
192         equals( div.data("attr"), "internal", "Check for .data('attr') precedence (internal > external data-* attribute)" );
193         
194         child.appendTo('#main');
195         equals( child.data("myobj"), "old data", "Value accessed from data-* attribute");
196
197         child.data("myobj", "replaced");
198         equals( child.data("myobj"), "replaced", "Original data overwritten");
199
200         child.data("ignored", "cache");
201         equals( child.data("ignored"), "cache", "Cached data used before DOM data-* fallback");
202
203         child
204                 .attr("data-true", "true")
205                 .attr("data-false", "false")
206                 .attr("data-five", "5")
207                 .attr("data-point", "5.5")
208                 .attr("data-pointe", "5.5E3")
209                 .attr("data-pointbad", "5..5")
210                 .attr("data-pointbad2", "-.")
211                 .attr("data-badjson", "{123}")
212                 .attr("data-badjson2", "[abc]")
213                 .attr("data-empty", "")
214                 .attr("data-space", " ")
215                 .attr("data-null", "null")
216                 .attr("data-string", "test");
217         
218         strictEqual( child.data('true'), true, "Primitive true read from attribute");
219         strictEqual( child.data('false'), false, "Primitive false read from attribute");
220         strictEqual( child.data('five'), 5, "Primitive number read from attribute");
221         strictEqual( child.data('point'), 5.5, "Primitive number read from attribute");
222         strictEqual( child.data('pointe'), 5500, "Primitive number read from attribute");
223         strictEqual( child.data('pointbad'), "5..5", "Bad number read from attribute");
224         strictEqual( child.data('pointbad2'), "-.", "Bad number read from attribute");
225         strictEqual( child.data('badjson'), "{123}", "Bad number read from attribute");
226         strictEqual( child.data('badjson2'), "[abc]", "Bad number read from attribute");
227         strictEqual( child.data('empty'), "", "Empty string read from attribute");
228         strictEqual( child.data('space'), " ", "Empty string read from attribute");
229         strictEqual( child.data('null'), null, "Primitive null read from attribute");
230         strictEqual( child.data('string'), "test", "Typical string read from attribute");
231
232         child.remove();
233         
234         // tests from metadata plugin
235         function testData(index, elem) {
236                 switch (index) {
237                 case 0:
238                         equals(jQuery(elem).data("foo"), "bar", "Check foo property");
239                         equals(jQuery(elem).data("bar"), "baz", "Check baz property");
240                         break;
241                 case 1:
242                         equals(jQuery(elem).data("test"), "bar", "Check test property");
243                         equals(jQuery(elem).data("bar"), "baz", "Check bar property");
244                         break;
245                 case 2:
246                         equals(jQuery(elem).data("zoooo"), "bar", "Check zoooo property");
247                         same(jQuery(elem).data("bar"), {"test":"baz"}, "Check bar property");
248                         break;
249                 case 3:
250                         equals(jQuery(elem).data("number"), true, "Check number property");
251                         same(jQuery(elem).data("stuff"), [2,8], "Check stuff property");
252                         break;
253                 default:
254                         ok(false, ["Assertion failed on index ", index, ", with data ", data].join(''));
255                 }
256         }
257         
258         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>',
259                 elem = jQuery(metadata).appendTo('#main');
260         
261         elem.find("li").each(testData);
262         elem.remove();
263 });
264
265 test(".data(Object)", function() {
266         expect(4);
267
268         var div = jQuery("<div/>");
269
270         div.data({ "test": "in", "test2": "in2" });
271         equals( div.data("test"), "in", "Verify setting an object in data" );
272         equals( div.data("test2"), "in2", "Verify setting an object in data" );
273         
274         var obj = {test:"unset"},
275                 jqobj = jQuery(obj);
276         jqobj.data({ "test": "in", "test2": "in2" });
277         equals( obj.test, "in", "Verify setting an object on an object extends the object" );
278         equals( obj.test2, "in2", "Verify setting an object on an object extends the object" ); 
279 });
280
281 test("jQuery.removeData", function() {
282         expect(4);
283         var div = jQuery("#foo")[0];
284         jQuery.data(div, "test", "testing");
285         jQuery.removeData(div, "test");
286         equals( jQuery.data(div, "test"), undefined, "Check removal of data" );
287         
288         var obj = {};
289         jQuery.data(obj, "test", "testing");
290         equals( obj.test, "testing", "verify data on plain object");
291         jQuery.removeData(obj, "test");
292         equals( jQuery.data(obj, "test"), undefined, "Check removal of data on plain object" );
293         equals( obj.test, undefined, "Check removal of data directly from plain object" );      
294 });
295
296 test(".removeData()", function() {
297         expect(6);
298         var div = jQuery("#foo");
299         div.data("test", "testing");
300         div.removeData("test");
301         equals( div.data("test"), undefined, "Check removal of data" );
302
303         div.data("test", "testing");
304         div.data("test.foo", "testing2");
305         div.removeData("test.bar");
306         equals( div.data("test.foo"), "testing2", "Make sure data is intact" );
307         equals( div.data("test"), "testing", "Make sure data is intact" );
308
309         div.removeData("test");
310         equals( div.data("test.foo"), "testing2", "Make sure data is intact" );
311         equals( div.data("test"), undefined, "Make sure data is intact" );
312
313         div.removeData("test.foo");
314         equals( div.data("test.foo"), undefined, "Make sure data is intact" );
315 });