Stop 'using namespace *Names' in files generated by make_names.pl
[WebKit-https.git] / Source / WebInspectorUI / UserInterface / Base / EventListener.js
1 /*
2  * Copyright (C) 2014, 2015 Apple Inc. All rights reserved.
3  * Copyright (C) 2013, 2014 University of Washington. All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  */
26
27 WI.EventListener = class EventListener
28 {
29     constructor(thisObject, fireOnce)
30     {
31         this._thisObject = thisObject;
32         this._emitter = null;
33         this._callback = null;
34         this._fireOnce = fireOnce;
35     }
36
37     // Public
38
39     connect(emitter, type, callback, usesCapture)
40     {
41         console.assert(!this._emitter && !this._callback, "EventListener already bound to a callback.", this);
42         console.assert(emitter, `Missing event emitter for event: ${type}.`);
43         console.assert(type, "Missing event type.");
44         console.assert(callback, `Missing callback for event: ${type}.`);
45         var emitterIsValid = emitter && (emitter instanceof WI.Object || emitter instanceof Node || (typeof emitter.addEventListener === "function"));
46         console.assert(emitterIsValid, "Event emitter ", emitter, ` (type: ${type}) is null or does not implement Node or WI.Object.`);
47
48         if (!emitterIsValid || !type || !callback)
49             return;
50
51         this._emitter = emitter;
52         this._type = type;
53         this._usesCapture = !!usesCapture;
54
55         if (emitter instanceof Node)
56             callback = callback.bind(this._thisObject);
57
58         if (this._fireOnce) {
59             var listener = this;
60             this._callback = function() {
61                 listener.disconnect();
62                 callback.apply(this, arguments);
63             };
64         } else
65             this._callback = callback;
66
67         if (this._emitter instanceof Node)
68             this._emitter.addEventListener(this._type, this._callback, this._usesCapture);
69         else
70             this._emitter.addEventListener(this._type, this._callback, this._thisObject);
71     }
72
73     disconnect()
74     {
75         console.assert(this._emitter && this._callback, "EventListener is not bound to a callback.", this);
76
77         if (!this._emitter || !this._callback)
78             return;
79
80         if (this._emitter instanceof Node)
81             this._emitter.removeEventListener(this._type, this._callback, this._usesCapture);
82         else
83             this._emitter.removeEventListener(this._type, this._callback, this._thisObject);
84
85         if (this._fireOnce)
86             delete this._thisObject;
87         delete this._emitter;
88         delete this._type;
89         delete this._callback;
90     }
91 };