| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file | |
| 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. | |
| 4 | |
| 5 /// Declarations for variable arguments support | |
| 6 /// (rest params and spread operator). | |
| 7 /// | |
| 8 /// These are currently *not* supported by dart2js or Dartium. | |
| 9 library js.varargs; | |
| 10 | |
| 11 class _Rest { | |
| 12 const _Rest(); | |
| 13 } | |
| 14 | |
| 15 /// Annotation to tag ES6 rest parameters (https://goo.gl/r0bJ1K). | |
| 16 /// | |
| 17 /// This is *not* supported by dart2js or Dartium (yet). | |
| 18 /// | |
| 19 /// This is meant to be used by the Dart Dev Compiler | |
| 20 /// when compiling helper functions of its runtime to ES6. | |
| 21 /// | |
| 22 /// The following function: | |
| 23 /// | |
| 24 /// foo(a, b, @rest others) { ... } | |
| 25 /// | |
| 26 /// Will be compiled to ES6 code like the following: | |
| 27 /// | |
| 28 /// function foo(a, b, ...others) { ... } | |
| 29 /// | |
| 30 /// Which is roughly equivalent to the following ES5 code: | |
| 31 /// | |
| 32 /// function foo(a, b/*, ...others*/) { | |
| 33 /// var others = [].splice.call(arguments, 2); | |
| 34 /// ... | |
| 35 /// } | |
| 36 /// | |
| 37 const _Rest rest = const _Rest(); | |
| 38 | |
| 39 /// Intrinsic function that maps to the ES6 spread operator | |
| 40 /// (https://goo.gl/NedHKr). | |
| 41 /// | |
| 42 /// This is *not* supported by dart2js or Dartium (yet), | |
| 43 /// and *cannot* be called at runtime. | |
| 44 /// | |
| 45 /// This is meant to be used by the Dart Dev Compiler when | |
| 46 /// compiling its runtime to ES6. | |
| 47 /// | |
| 48 /// The following expression: | |
| 49 /// | |
| 50 /// foo(a, b, spread(others)) | |
| 51 /// | |
| 52 /// Will be compiled to ES6 code like the following: | |
| 53 /// | |
| 54 /// foo(a, b, ...others) | |
| 55 /// | |
| 56 /// Which is roughly equivalent to the following ES5 code: | |
| 57 /// | |
| 58 /// foo.apply(null, [a, b].concat(others)) | |
| 59 /// | |
| 60 dynamic spread(args) { | |
| 61 throw new StateError( | |
| 62 'The spread function cannot be called, ' | |
| 63 'it should be compiled away.'); | |
| 64 } | |
| OLD | NEW |