dart2js kernel: generate `other==null` header for operator== methods

pkg/compiler/lib/src/ssa/builder_kernel.dart

 // Copyright (c) 2016, 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.
 
 import 'package:kernel/ast.dart' as ir;
 
 import '../closure.dart';
 import '../common.dart';
 import '../common/codegen.dart' show CodegenRegistry;
 import '../common/names.dart';
@@ skipping 630 matching lines @@
     openFunction();
     _addClassTypeVariablesIfNeeded(constructor);
     constructor.function.body.accept(this);
     closeFunction();
   }
 
   /// Builds a SSA graph for FunctionNodes, found in FunctionExpressions and
   /// Procedures.
   void buildFunctionNode(ir.FunctionNode functionNode) {
     openFunction();
-    if (functionNode.parent is ir.Procedure &&
-        (functionNode.parent as ir.Procedure).kind ==
-            ir.ProcedureKind.Factory) {
+    ir.TreeNode parent = functionNode.parent;
+    if (parent is ir.Procedure && parent.kind == ir.ProcedureKind.Factory) {
       _addClassTypeVariablesIfNeeded(functionNode.parent);
     }
+
+    // If [functionNode] is `operator==` we explicitly add a null check at the
+    // beginning of the method. This is to avoid having call sites do the null
+    // check.
+    if (parent is ir.Procedure &&
+        parent.kind == ir.ProcedureKind.Operator &&
+        parent.name.name == '==') {
+      if (!backend
+          .operatorEqHandlesNullArgument(astAdapter.getMethod(parent))) {
+        handleIf(
+          visitCondition: () {
+            HParameterValue parameter = parameters.values.first;
+            push(new HIdentity(parameter, graph.addConstantNull(closedWorld),
+                null, commonMasks.boolType));
+          },
+          visitThen: () {
+            closeAndGotoExit(new HReturn(
+                graph.addConstantBool(false, closedWorld),
+                sourceInformationBuilder
+                    .buildImplicitReturn(astAdapter.getElement(parent))));
+          },
+          visitElse: null,
+          // TODO(27394): Add sourceInformation via
+          // `sourceInformationBuilder.buildIf(?)`.
+        );
+      }
+    }
     functionNode.body.accept(this);
     closeFunction();
   }
 
   void addImplicitInstantiation(ResolutionDartType type) {
     if (type != null) {
       currentImplicitInstantiations.add(type);
     }
   }
 
@@ skipping 2748 matching lines @@
     enterBlock.setBlockFlow(
         new HTryBlockInformation(
             kernelBuilder.wrapStatementGraph(bodyGraph),
             exception,
             kernelBuilder.wrapStatementGraph(catchGraph),
             kernelBuilder.wrapStatementGraph(finallyGraph)),
         exitBlock);
     kernelBuilder.inTryStatement = previouslyInTryStatement;
   }
 }