html-document/src/Event.js

Partial implementation of document, HTMLElement for node

/**
 * The Element interface represents an object within a DOM document.
 * This interface describes methods and properties common to all kinds of elements.
 * Specific behaviors are described in interfaces which inherit from Element but add additional functionality.
 *
 * @see https://developer.mozilla.org/en/docs/Web/API/Event
 * @class Event
 */
export default class Event {
    /**
     * @param {String} type
     */
    constructor(type: string) {
        /**
         * A boolean indicating whether the event bubbles up through the DOM or not.
         * @member {Boolean} Event#bubbles
         * @readonly
         */
        this.bubbles = false;

        /**
         * A boolean indicating whether the event is cancelable.
         * @member {Boolean} Event#cancelable
         * @readonly
         */
        this.cancelable = false;

        /**
         * A reference to the currently registered target for the event.
         * @member {HTMLElement} Event#currentTarget
         * @readonly
         */
        this.currentTarget = false;

        /**
         * Indicates whether or not event.preventDefault() has been called on the event.
         * @member {Boolean} Event#defaultPrevented
         * @readonly
         */
        this.defaultPrevented = false;

        /**
         * Indicates which phase of the event flow is being processed.
         * @member {Number} Event#eventPhase
         * @readonly
         */
        this.eventPhase = 0;

        /**
         * A reference to the target to which the event was originally dispatched.
         * @member {HTMLElement} Event#target
         * @readonly
         */
        this.target = null;

        /**
         * The time that the event was created.
         * @member {Number} Event#timeStamp
         * @readonly
         */
        this.timeStamp = Date.now() * 1000;

        /**
         * The name of the event (case-insensitive).
         * @member {String} Event#type
         * @readonly
         */
        this.type = type.toLowerCase();

        /**
         * Indicates whether or not the event was initiated by the browser (after a user click for instance)
         * or by a script (using an event creation method)
         * @member {Boolean} Event#isTrusted
         * @readonly
         */
        this.isTrusted = false;
    }

    /**
     * @method Event#preventDefault
     */
    preventDefault() {
        this.defaultPrevented = true;
    }

    /**
     * @method Event#stopImmediatePropagation
     */
    stopImmediatePropagation() {
        this.immediatePropagationStopped = true;
        this.stopPropagation();
    }

    /**
     * @method Event#stopPropagation
     */
    stopPropagation() {
        this.propagationStopped = true;
    }

    /**
     * @method Event#isImmediatePropagationStopped
     * @return {Boolean}
     */
    isImmediatePropagationStopped() {
        return this.immediatePropagationStopped;
    }
}