Bring events to JavaScript components

remoting/webapp/js_proto/base_proto.js

+// Copyright (c) 2012 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+// This file contains various hacks needed to inform JSCompiler of various
+// properties and methods defined in base.js. It is used only with
+// JSCompiler to verify the type-correctness of our code.

[Jamie, 2014/04/22 01:23:21]

This should not be necessary. We have proto files for types defined externally
to the web-app, but this is code we're fully in control of. In particular, you
can get rid of the @this directive in the implementation file and just rename it
to EventSource to get the benefits of most of these directives.

[kelvinp, 2014/04/23 00:24:20]

Done.

+
+/** @constructor */
+function EventEntry () {}
+
+/** @param {Array.<function(?=)>} listeners */
+EventEntry.prototype.listeners = null;
+/** @param {boolean} sweepRequired */
+EventEntry.prototype.sweepRequired = null;
+/** @param {number} recursionCount */
+EventEntry.prototype.recursionCount = null;
+
+/** @constructor */
+function EventSource () {}
+
+/** @type {Object.<string, EventEntry>}  */
+EventSource.prototype._ev = null;
+
+/**
+ * @param {string} type
+ * @param {function(?=)} fn
+ * @param {*} thisObj
+ */
+EventSource.prototype.addEventListener = function (type, fn, thisObj) {};
+
+/**
+ * @param {string} type
+ * @param {function(?=)} fn
+ * @param {*} thisObj
+ */
+EventSource.prototype.removeEventListener = function (type, fn, thisObj) {};
+
+/**
+ * @param {string} type
+ * @param {?} data
+ */
+EventSource.prototype.raiseEvent = function (type, data) {};
+
+/** @param {Array.<string>} evts */
+EventSource.prototype.defineEvents = function (evts) {};
+
+/**
+  * @interface
+  */
+function Disposable () {}
+Disposable.prototype.dispose = function () {};