dart2js: add compiler builtins to the core-runtime.

sdk/lib/_internal/compiler/js_lib/foreign_helper.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library _foreign_helper;
 
-import 'dart:_js_embedded_names' show JsGetName;
+import 'dart:_js_embedded_names' show JsGetName, JsBuiltin;
 
 /**
  * Emits a JavaScript code fragment parameterized by arguments.
  *
  * Hash characters `#` in the [codeTemplate] are replaced in left-to-right order
  * with expressions that contain the values of, or evaluate to, the arguments.
  * The number of hash marks must match the number or arguments.  Although
  * declared with arguments [arg0] through [arg2], the form actually has no limit
  * on the number of arguments.
  *
@@ skipping 165 matching lines @@
  * https://code.google.com/p/v8/wiki/JavaScriptStackTraceApi.
  */
 RAW_DART_FUNCTION_REF(Function function) {}
 
 /**
  * Sets the current isolate to [isolate].
  */
 void JS_SET_CURRENT_ISOLATE(isolate) {}
 
 /**
- * Returns the JavaScript constructor function for Dart's Object class.
- * This can be used for type tests, as in
- *
- *     if (JS('bool', '# instanceof #', obj, JS_DART_OBJECT_CONSTRUCTOR()))
- *       ...
- */
-JS_DART_OBJECT_CONSTRUCTOR() {}
-
-/**
  * Returns the interceptor for class [type].  The interceptor is the type's
  * constructor's `prototype` property.  [type] will typically be the class, not
  * an interface, e.g. `JS_INTERCEPTOR_CONSTANT(JSInt)`, not
  * `JS_INTERCEPTOR_CONSTANT(int)`.
  */
 JS_INTERCEPTOR_CONSTANT(Type type) {}
 
 /**
  * Returns the prefix used for generated is checks on classes.
  */
 String JS_OPERATOR_IS_PREFIX() {}
 
 /**
  * Returns the prefix used for generated type argument substitutions on classes.
  */
 String JS_OPERATOR_AS_PREFIX() {}
 
 /// Returns the name of the class `Object` in the generated code.
 String JS_OBJECT_CLASS_NAME() {}
 
 /// Returns the name of the class `Null` in the generated code.
 String JS_NULL_CLASS_NAME() {}
 
-/// Returns the name of the class `Function` in the generated code.
-String JS_FUNCTION_CLASS_NAME() {}
-
 /**
  * Returns the field name used for determining if an object or its
  * interceptor has JavaScript indexing behavior.
  */
 String JS_IS_INDEXABLE_FIELD_NAME() {}
 
 /**
  * Returns the object corresponding to Namer.CURRENT_ISOLATE.
  */
 JS_CURRENT_ISOLATE() {}
 
 /// Returns the name used for generated function types on classes and methods.
 String JS_SIGNATURE_NAME() {}
 
 /// Returns the name used to tag typedefs.
 String JS_TYPEDEF_TAG() {}
 
-/// Returns the name used to tag function type representations in JavaScript.
-String JS_FUNCTION_TYPE_TAG() {}
-
 /**
  * Returns the name used to tag void return in function type representations
  * in JavaScript.
  */
 String JS_FUNCTION_TYPE_VOID_RETURN_TAG() {}
 
 /**
  * Returns the name used to tag return types in function type representations
  * in JavaScript.
  */
@@ skipping 18 matching lines @@
 String JS_FUNCTION_TYPE_NAMED_PARAMETERS_TAG() {}
 
 /// Returns the JS name for [name] from the Namer.
 String JS_GET_NAME(JsGetName name) {}
 
 /// Reads an embedded global.
 ///
 /// The [name] should be a constant defined in the `_embedded_names` library.
 JS_EMBEDDED_GLOBAL(String typeDescription, String name) {}
 
+/// Instructs the compiler to execute the [builtinName] action at the call-site.
+///
+/// The [builtin] should be a constant defined in the `_embedded_names`
+/// library.
+// Add additional optional arguments if needed. The method is treated internally
+// as a variable argument method.
+JS_BUILTIN(String typeDescription, JsBuiltin builtin,
+           [arg0, arg1, arg2, arg3, arg4, arg5, arg6,
+            arg7, arg8, arg9, arg10, arg11]) {}
+
 /// Returns the state of a flag that is determined by the state of the compiler
 /// when the program has been analyzed.
 bool JS_GET_FLAG(String name) {}
 
 /**
  * Pretend [code] is executed.  Generates no executable code.  This is used to
  * model effects at some other point in external code.  For example, the
  * following models an assignment to foo with an unknown value.
  *
  *     var foo;
@@ skipping 22 matching lines @@
 }
 
 /**
  * JavaScript string concatenation. Inputs must be Strings.  Corresponds to the
  * HStringConcat SSA instruction and may be constant-folded.
  */
 String JS_STRING_CONCAT(String a, String b) {
   // This body is unused, only here for type analysis.
   return JS('String', '# + #', a, b);
 }