OLD | NEW |
---|---|
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 library dart.js; | 5 library dart.js; |
6 | 6 |
7 import 'dart:html' show Blob, ImageData, Node; | |
alexandre.ardhuin
2013/10/18 08:09:36
When we started dart:js, we saw a big impact on js
justinfagnani
2013/10/18 22:38:41
Replied in CL-level comment, but I'm going to take
| |
8 import 'dart:indexed_db' show KeyRange; | |
9 import 'dart:collection' show HashMap; | |
7 import 'dart:_foreign_helper' show JS, DART_CLOSURE_TO_JS; | 10 import 'dart:_foreign_helper' show JS, DART_CLOSURE_TO_JS; |
11 import 'dart:_interceptors' show JavaScriptObject, UnknownJavaScriptObject; | |
8 import 'dart:_js_helper' show Primitives, convertDartClosureToJS; | 12 import 'dart:_js_helper' show Primitives, convertDartClosureToJS; |
9 | 13 |
10 final JsObject context = new JsObject._fromJs(Primitives.computeGlobalThis()); | 14 final JsObject context = new JsObject._fromJs(Primitives.computeGlobalThis()); |
11 | 15 |
12 JsObject jsify(dynamic data) => data == null ? null : new JsObject._json(data); | |
13 | |
14 class Callback implements Serializable<JsFunction> { | |
15 final Function _f; // here to allow capture in closure | |
16 final bool _withThis; // here to allow capture in closure | |
17 dynamic _jsFunction; | |
18 | |
19 Callback._(this._f, this._withThis) { | |
20 _jsFunction = JS('', r''' | |
21 (function(){ | |
22 var f = #; | |
23 return function(){ | |
24 return f(this, Array.prototype.slice.apply(arguments)); | |
25 }; | |
26 }).apply(this)''', convertDartClosureToJS(_call, 2)); | |
27 } | |
28 | |
29 factory Callback(Function f) => new Callback._(f, false); | |
30 factory Callback.withThis(Function f) => new Callback._(f, true); | |
31 | |
32 _call(thisArg, List args) { | |
33 final arguments = new List.from(args); | |
34 if (_withThis) arguments.insert(0, thisArg); | |
35 final dartArgs = arguments.map(_convertToDart).toList(); | |
36 return _convertToJS(Function.apply(_f, dartArgs)); | |
37 } | |
38 | |
39 JsFunction toJs() => new JsFunction._fromJs(_jsFunction); | |
40 } | |
41 | |
42 /* | |
43 * TODO(justinfagnani): add tests and make public when we remove Callback. | |
44 * | |
45 * Returns a [JsFunction] that captures its 'this' binding and calls [f] | |
46 * with the value of this passed as the first argument. | |
47 */ | |
48 JsFunction _captureThis(Function f) => | |
49 new JsFunction._fromJs(_convertDartFunction(f, captureThis: true)); | |
50 | |
51 _convertDartFunction(Function f, {bool captureThis: false}) { | 16 _convertDartFunction(Function f, {bool captureThis: false}) { |
52 return JS('', | 17 return JS('', |
53 'function(_call, f, captureThis) {' | 18 'function(_call, f, captureThis) {' |
54 'return function() {' | 19 'return function() {' |
55 'return _call(f, captureThis, this, ' | 20 'return _call(f, captureThis, this, ' |
56 'Array.prototype.slice.apply(arguments));' | 21 'Array.prototype.slice.apply(arguments));' |
57 '}' | 22 '}' |
58 '}(#, #, #)', DART_CLOSURE_TO_JS(_callDartFunction), f, captureThis); | 23 '}(#, #, #)', DART_CLOSURE_TO_JS(_callDartFunction), f, captureThis); |
59 } | 24 } |
60 | 25 |
61 _callDartFunction(callback, bool captureThis, self, List arguments) { | 26 _callDartFunction(callback, bool captureThis, self, List arguments) { |
62 if (captureThis) { | 27 if (captureThis) { |
63 arguments = [self]..addAll(arguments); | 28 arguments = [self]..addAll(arguments); |
64 } | 29 } |
65 var dartArgs = arguments.map(_convertToDart).toList(); | 30 var dartArgs = arguments.map(_convertToDart).toList(); |
66 return _convertToJS(Function.apply(callback, dartArgs)); | 31 return _convertToJS(Function.apply(callback, dartArgs)); |
67 } | 32 } |
68 | 33 |
69 | 34 |
70 class JsObject implements Serializable<JsObject> { | 35 class JsObject { |
71 // The wrapped JS object. | 36 // The wrapped JS object. |
72 final dynamic _jsObject; | 37 final dynamic _jsObject; |
73 | 38 |
74 JsObject._fromJs(this._jsObject) { | 39 JsObject._fromJs(this._jsObject) { |
40 assert(_jsObject != null); | |
75 // Remember this proxy for the JS object | 41 // Remember this proxy for the JS object |
76 _getDartProxy(_jsObject, _DART_OBJECT_PROPERTY_NAME, (o) => this); | 42 _getDartProxy(_jsObject, _DART_OBJECT_PROPERTY_NAME, (o) => this); |
77 } | 43 } |
78 | 44 |
79 // TODO(vsm): Type constructor as Serializable<JsFunction> when | 45 /** |
80 // dartbug.com/11854 is fixed. | 46 * Expert use only: |
81 factory JsObject(constructor, [List arguments]) { | 47 * |
48 * Use this constructor only if you wish to get access to JS properties | |
49 * attached to a browser host object such as a Node or Blob. This constructor | |
50 * will return a JsObject proxy on [object], even though the object would | |
51 * normally be returned as a native Dart object. | |
52 * | |
53 * An exception will be thrown if [object] is a primitive type or null. | |
54 */ | |
55 factory JsObject.fromBrowserObject(Object object) { | |
56 if (object is num || object is String || object is bool || object == null) { | |
57 throw new ArgumentError( | |
58 "object cannot be a num, string, bool, or null"); | |
59 } | |
60 return new JsObject._fromJs(_convertToJS(object)); | |
61 } | |
62 | |
63 /** | |
64 * Converts a json-like [data] to a JavaScript map or array and return a | |
65 * [JsObject] to it. | |
66 */ | |
67 factory JsObject.jsify(Object object) { | |
68 if ((object is! Map) && (object is! Iterable)) { | |
69 throw new ArgumentError("object must be a Map or Iterable"); | |
70 } | |
71 return new JsObject._fromJs(_convertDataTree(object)); | |
72 } | |
73 | |
74 factory JsObject(JsFunction constructor, [List arguments]) { | |
82 var constr = _convertToJS(constructor); | 75 var constr = _convertToJS(constructor); |
83 if (arguments == null) { | 76 if (arguments == null) { |
84 return new JsObject._fromJs(JS('', 'new #()', constr)); | 77 return new JsObject._fromJs(JS('', 'new #()', constr)); |
85 } | 78 } |
86 // The following code solves the problem of invoking a JavaScript | 79 // The following code solves the problem of invoking a JavaScript |
87 // constructor with an unknown number arguments. | 80 // constructor with an unknown number arguments. |
88 // First bind the constructor to the argument list using bind.apply(). | 81 // First bind the constructor to the argument list using bind.apply(). |
89 // The first argument to bind() is the binding of 'this', so add 'null' to | 82 // The first argument to bind() is the binding of 'this', so add 'null' to |
90 // the arguments list passed to apply(). | 83 // the arguments list passed to apply(). |
91 // After that, use the JavaScript 'new' operator which overrides any binding | 84 // After that, use the JavaScript 'new' operator which overrides any binding |
92 // of 'this' with the new instance. | 85 // of 'this' with the new instance. |
93 var args = [null]..addAll(arguments.map(_convertToJS)); | 86 var args = [null]..addAll(arguments.map(_convertToJS)); |
94 var factoryFunction = JS('', '#.bind.apply(#, #)', constr, constr, args); | 87 var factoryFunction = JS('', '#.bind.apply(#, #)', constr, constr, args); |
95 // Without this line, calling factoryFunction as a constructor throws | 88 // Without this line, calling factoryFunction as a constructor throws |
96 JS('String', 'String(#)', factoryFunction); | 89 JS('String', 'String(#)', factoryFunction); |
97 return new JsObject._fromJs(JS('', 'new #()', factoryFunction)); | 90 // This could return an UnknownJavaScriptObject, or a native |
91 // object for which there is an interceptor | |
92 var jsObj = JS('JavaScriptObject', 'new #()', factoryFunction); | |
93 return new JsObject._fromJs(jsObj); | |
98 } | 94 } |
99 | 95 |
100 factory JsObject._json(data) => new JsObject._fromJs(_convertDataTree(data)); | 96 // TODO: handle cycles |
97 static _convertDataTree(data) { | |
98 var _convertedObjects = new HashMap.identity(); | |
101 | 99 |
102 static _convertDataTree(data) { | 100 _convert(o) { |
103 if (data is Map) { | 101 if (_convertedObjects.containsKey(o)) { |
104 final convertedData = JS('=Object', '{}'); | 102 return _convertedObjects[o]; |
105 for (var key in data.keys) { | |
106 JS('=Object', '#[#]=#', convertedData, key, | |
107 _convertDataTree(data[key])); | |
108 } | 103 } |
109 return convertedData; | 104 if (o is Map) { |
110 } else if (data is Iterable) { | 105 final convertedMap = JS('=Object', '{}'); |
111 return data.map(_convertDataTree).toList(); | 106 _convertedObjects[o] = convertedMap; |
112 } else { | 107 for (var key in o.keys) { |
113 return _convertToJS(data); | 108 JS('=Object', '#[#]=#', convertedMap, key, _convert(o[key])); |
109 } | |
110 return convertedMap; | |
111 } else if (o is Iterable) { | |
112 var convertedList = []; | |
113 _convertedObjects[o] = convertedList; | |
114 convertedList.addAll(o.map(_convert)); | |
115 return convertedList; | |
116 } else { | |
117 return _convertToJS(o); | |
118 } | |
114 } | 119 } |
120 | |
121 return _convert(data); | |
115 } | 122 } |
116 | 123 |
117 JsObject toJs() => this; | |
118 | |
119 /** | 124 /** |
120 * Returns the value associated with [key] from the proxied JavaScript | 125 * Returns the value associated with [key] from the proxied JavaScript |
121 * object. | 126 * object. |
122 * | 127 * |
123 * [key] must either be a [String] or [int]. | 128 * [key] must either be a [String] or [num]. |
124 */ | 129 */ |
125 // TODO(justinfagnani): rename key/name to property | 130 // TODO(justinfagnani): rename key/name to property |
126 dynamic operator[](key) { | 131 dynamic operator[](key) { |
127 if (key is! String && key is! int) { | 132 if (key is! String && key is! num) { |
128 throw new ArgumentError("key is not a String or int"); | 133 throw new ArgumentError("key is not a String or num"); |
129 } | 134 } |
130 return _convertToDart(JS('', '#[#]', _jsObject, key)); | 135 return _convertToDart(JS('', '#[#]', _jsObject, key)); |
131 } | 136 } |
132 | 137 |
133 /** | 138 /** |
134 * Sets the value associated with [key] from the proxied JavaScript | 139 * Sets the value associated with [key] from the proxied JavaScript |
135 * object. | 140 * object. |
136 * | 141 * |
137 * [key] must either be a [String] or [int]. | 142 * [key] must either be a [String] or [num]. |
138 */ | 143 */ |
139 operator[]=(key, value) { | 144 operator[]=(key, value) { |
140 if (key is! String && key is! int) { | 145 if (key is! String && key is! num) { |
141 throw new ArgumentError("key is not a String or int"); | 146 throw new ArgumentError("key is not a String or num"); |
142 } | 147 } |
143 JS('', '#[#]=#', _jsObject, key, _convertToJS(value)); | 148 JS('', '#[#]=#', _jsObject, key, _convertToJS(value)); |
144 } | 149 } |
145 | 150 |
146 int get hashCode => 0; | 151 int get hashCode => 0; |
147 | 152 |
148 bool operator==(other) => other is JsObject && | 153 bool operator==(other) => other is JsObject && |
149 JS('bool', '# === #', _jsObject, other._jsObject); | 154 JS('bool', '# === #', _jsObject, other._jsObject); |
150 | 155 |
151 bool hasProperty(name) { | 156 bool hasProperty(name) { |
152 if (name is! String && name is! int) { | 157 if (name is! String && name is! num) { |
153 throw new ArgumentError("name is not a String or int"); | 158 throw new ArgumentError("name is not a String or num"); |
154 } | 159 } |
155 return JS('bool', '# in #', name, _jsObject); | 160 return JS('bool', '# in #', name, _jsObject); |
156 } | 161 } |
157 | 162 |
158 void deleteProperty(name) { | 163 void deleteProperty(name) { |
159 if (name is! String && name is! int) { | 164 if (name is! String && name is! num) { |
160 throw new ArgumentError("name is not a String or int"); | 165 throw new ArgumentError("name is not a String or num"); |
161 } | 166 } |
162 JS('bool', 'delete #[#]', _jsObject, name); | 167 JS('bool', 'delete #[#]', _jsObject, name); |
163 } | 168 } |
164 | 169 |
165 // TODO(vsm): Type type as Serializable<JsFunction> when | |
166 // dartbug.com/11854 is fixed. | |
167 bool instanceof(type) { | 170 bool instanceof(type) { |
168 return JS('bool', '# instanceof #', _jsObject, _convertToJS(type)); | 171 return JS('bool', '# instanceof #', _jsObject, _convertToJS(type)); |
169 } | 172 } |
170 | 173 |
171 String toString() { | 174 String toString() { |
172 try { | 175 try { |
173 return JS('String', 'String(#)', _jsObject); | 176 return JS('String', 'String(#)', _jsObject); |
174 } catch(e) { | 177 } catch(e) { |
175 return super.toString(); | 178 return super.toString(); |
176 } | 179 } |
177 } | 180 } |
178 | 181 |
179 dynamic callMethod(name, [List args]) { | 182 dynamic callMethod(name, [List args]) { |
180 if (name is! String && name is! int) { | 183 if (name is! String && name is! num) { |
181 throw new ArgumentError("name is not a String or int"); | 184 throw new ArgumentError("name is not a String or num"); |
182 } | 185 } |
183 return _convertToDart(JS('', '#[#].apply(#, #)', _jsObject, name, | 186 return _convertToDart(JS('', '#[#].apply(#, #)', _jsObject, name, |
184 _jsObject, | 187 _jsObject, |
185 args == null ? null : args.map(_convertToJS).toList())); | 188 args == null ? null : args.map(_convertToJS).toList())); |
186 } | 189 } |
187 } | 190 } |
188 | 191 |
189 class JsFunction extends JsObject implements Serializable<JsFunction> { | 192 class JsFunction extends JsObject { |
193 | |
194 /* | |
195 * Returns a [JsFunction] that captures its 'this' binding and calls [f] | |
196 * with the value of this passed as the first argument. | |
197 */ | |
198 factory JsFunction.withThis(Function f) { | |
199 var jsFunc = _convertDartFunction(f, captureThis: true); | |
200 return new JsFunction._fromJs(jsFunc); | |
201 } | |
190 | 202 |
191 JsFunction._fromJs(jsObject) : super._fromJs(jsObject); | 203 JsFunction._fromJs(jsObject) : super._fromJs(jsObject); |
192 | 204 |
193 dynamic apply(thisArg, [List args]) => | 205 dynamic apply([thisArg, List args]) => |
194 _convertToDart(JS('', '#.apply(#, #)', _jsObject, | 206 _convertToDart(JS('', '#.apply(#, #)', _jsObject, |
195 _convertToJS(thisArg), | 207 _convertToJS(thisArg), |
196 args == null ? null : args.map(_convertToJS).toList())); | 208 args == null ? null : args.map(_convertToJS).toList())); |
197 } | 209 } |
198 | 210 |
199 abstract class Serializable<T> { | |
200 T toJs(); | |
201 } | |
202 | |
203 // property added to a Dart object referencing its JS-side DartObject proxy | 211 // property added to a Dart object referencing its JS-side DartObject proxy |
204 const _DART_OBJECT_PROPERTY_NAME = r'_$dart_dartObject'; | 212 const _DART_OBJECT_PROPERTY_NAME = r'_$dart_dartObject'; |
205 const _DART_CLOSURE_PROPERTY_NAME = r'_$dart_dartClosure'; | 213 const _DART_CLOSURE_PROPERTY_NAME = r'_$dart_dartClosure'; |
206 | 214 |
207 // property added to a JS object referencing its Dart-side JsObject proxy | 215 // property added to a JS object referencing its Dart-side JsObject proxy |
208 const _JS_OBJECT_PROPERTY_NAME = r'_$dart_jsObject'; | 216 const _JS_OBJECT_PROPERTY_NAME = r'_$dart_jsObject'; |
209 const _JS_FUNCTION_PROPERTY_NAME = r'$dart_jsFunction'; | 217 const _JS_FUNCTION_PROPERTY_NAME = r'$dart_jsFunction'; |
210 | 218 |
211 bool _defineProperty(o, String name, value) { | 219 bool _defineProperty(o, String name, value) { |
212 if (JS('bool', 'Object.isExtensible(#)', o)) { | 220 if (JS('bool', 'Object.isExtensible(#)', o)) { |
213 try { | 221 try { |
214 JS('void', 'Object.defineProperty(#, #, { value: #})', o, name, value); | 222 JS('void', 'Object.defineProperty(#, #, { value: #})', o, name, value); |
215 return true; | 223 return true; |
216 } catch(e) { | 224 } catch(e) { |
217 // object is native and lies about being extensible | 225 // object is native and lies about being extensible |
218 // see https://bugzilla.mozilla.org/show_bug.cgi?id=775185 | 226 // see https://bugzilla.mozilla.org/show_bug.cgi?id=775185 |
219 } | 227 } |
220 } | 228 } |
221 return false; | 229 return false; |
222 } | 230 } |
223 | 231 |
224 dynamic _convertToJS(dynamic o) { | 232 dynamic _convertToJS(dynamic o) { |
225 if (o == null) { | 233 if (o == null) { |
226 return null; | 234 return null; |
227 } else if (o is String || o is num || o is bool) { | 235 } else if (o is String || o is num || o is bool |
236 || o is Blob || o is KeyRange || o is ImageData || o is Node ) { | |
228 return o; | 237 return o; |
238 } else if (o is DateTime) { | |
239 return Primitives.lazyAsJsDate(o); | |
229 } else if (o is JsObject) { | 240 } else if (o is JsObject) { |
230 return o._jsObject; | 241 return o._jsObject; |
231 } else if (o is Serializable) { | |
232 return _convertToJS(o.toJs()); | |
233 } else if (o is Function) { | 242 } else if (o is Function) { |
234 return _getJsProxy(o, _JS_FUNCTION_PROPERTY_NAME, (o) { | 243 return _getJsProxy(o, _JS_FUNCTION_PROPERTY_NAME, (o) { |
235 var jsFunction = _convertDartFunction(o); | 244 var jsFunction = _convertDartFunction(o); |
236 // set a property on the JS closure referencing the Dart closure | 245 // set a property on the JS closure referencing the Dart closure |
237 _defineProperty(jsFunction, _DART_CLOSURE_PROPERTY_NAME, o); | 246 _defineProperty(jsFunction, _DART_CLOSURE_PROPERTY_NAME, o); |
238 return jsFunction; | 247 return jsFunction; |
239 }); | 248 }); |
240 } else { | 249 } else { |
241 return _getJsProxy(o, _JS_OBJECT_PROPERTY_NAME, | 250 return _getJsProxy(o, _JS_OBJECT_PROPERTY_NAME, |
242 (o) => JS('', 'new DartObject(#)', o)); | 251 (o) => JS('', 'new DartObject(#)', o)); |
(...skipping 10 matching lines...) Expand all Loading... | |
253 } | 262 } |
254 | 263 |
255 // converts a Dart object to a reference to a native JS object | 264 // converts a Dart object to a reference to a native JS object |
256 // which might be a DartObject JS->Dart proxy | 265 // which might be a DartObject JS->Dart proxy |
257 Object _convertToDart(o) { | 266 Object _convertToDart(o) { |
258 if (JS('bool', '# == null', o) || | 267 if (JS('bool', '# == null', o) || |
259 JS('bool', 'typeof # == "string"', o) || | 268 JS('bool', 'typeof # == "string"', o) || |
260 JS('bool', 'typeof # == "number"', o) || | 269 JS('bool', 'typeof # == "number"', o) || |
261 JS('bool', 'typeof # == "boolean"', o)) { | 270 JS('bool', 'typeof # == "boolean"', o)) { |
262 return o; | 271 return o; |
272 } else if (o is Blob || o is DateTime || o is KeyRange || o is ImageData || o is Node) { | |
273 return JS('Blob|DateTime|KeyRange|ImageData|Node', '#', o); | |
263 } else if (JS('bool', 'typeof # == "function"', o)) { | 274 } else if (JS('bool', 'typeof # == "function"', o)) { |
264 return _getDartProxy(o, _DART_CLOSURE_PROPERTY_NAME, | 275 return _getDartProxy(o, _DART_CLOSURE_PROPERTY_NAME, |
265 (o) => new JsFunction._fromJs(o)); | 276 (o) => new JsFunction._fromJs(o)); |
266 } else if (JS('bool', '#.constructor === DartObject', o)) { | 277 } else if (JS('bool', '#.constructor === DartObject', o)) { |
267 return JS('', '#.o', o); | 278 return JS('', '#.o', o); |
268 } else { | 279 } else { |
269 return _getDartProxy(o, _DART_OBJECT_PROPERTY_NAME, | 280 return _getDartProxy(o, _DART_OBJECT_PROPERTY_NAME, |
270 (o) => new JsObject._fromJs(o)); | 281 (o) => new JsObject._fromJs(o)); |
271 } | 282 } |
272 } | 283 } |
273 | 284 |
274 Object _getDartProxy(o, String propertyName, createProxy(o)) { | 285 Object _getDartProxy(o, String propertyName, createProxy(o)) { |
275 var dartProxy = JS('', '#[#]', o, propertyName); | 286 var dartProxy = JS('', '#[#]', o, propertyName); |
276 if (dartProxy == null) { | 287 if (dartProxy == null) { |
277 dartProxy = createProxy(o); | 288 dartProxy = createProxy(o); |
278 _defineProperty(o, propertyName, dartProxy); | 289 _defineProperty(o, propertyName, dartProxy); |
279 } | 290 } |
280 return dartProxy; | 291 return dartProxy; |
281 } | 292 } |
OLD | NEW |