chromium/third_party/google-closure-library/closure/goog/labs/dom/pagevisibilitymonitor.js

/**
 * @license
 * Copyright The Closure Library Authors.
 * SPDX-License-Identifier: Apache-2.0
 */

/**
 * @fileoverview This event monitor wraps the Page Visibility API.
 * @see http://www.w3.org/TR/page-visibility/
 */

goog.provide('goog.labs.dom.PageVisibilityMonitor');

goog.require('goog.dom');
goog.require('goog.dom.vendor');
goog.require('goog.events');
goog.require('goog.events.EventTarget');
goog.require('goog.events.EventType');
goog.require('goog.labs.dom.PageVisibilityEvent');
goog.require('goog.labs.dom.PageVisibilityState');
goog.require('goog.memoize');
goog.requireType('goog.events.BrowserEvent');

/**
 * This event handler allows you to catch page visibility change events.
 * @param {!goog.dom.DomHelper=} opt_domHelper
 * @constructor
 * @extends {goog.events.EventTarget}
 * @final
 */
goog.labs.dom.PageVisibilityMonitor = function(opt_domHelper) {
  'use strict';
  goog.labs.dom.PageVisibilityMonitor.base(this, 'constructor');

  /**
   * @private {!goog.dom.DomHelper}
   */
  this.domHelper_ = opt_domHelper || goog.dom.getDomHelper();

  /**
   * @private {?string}
   */
  this.eventType_ = this.getBrowserEventType_();

  // Some browsers do not support visibilityChange and therefore we don't bother
  // setting up events.
  if (this.eventType_) {
    /**
     * @private {goog.events.Key}
     */
    this.eventKey_ = goog.events.listen(
        this.domHelper_.getDocument(), this.eventType_,
        goog.bind(this.handleChange_, this));
  }
};
goog.inherits(goog.labs.dom.PageVisibilityMonitor, goog.events.EventTarget);


/**
 * @return {?string} The visibility change event type, or null if not supported.
 *     Memoized for performance.
 * @private
 */
goog.labs.dom.PageVisibilityMonitor.prototype
    .getBrowserEventType_ = goog.memoize(function() {
  'use strict';
  var isSupported =
      /** @type {!goog.labs.dom.PageVisibilityMonitor} */ (this).isSupported();
  var isPrefixed =
      /** @type {!goog.labs.dom.PageVisibilityMonitor} */ (this).isPrefixed_();

  if (isSupported) {
    return isPrefixed ?
        goog.dom.vendor.getPrefixedEventType(
            goog.events.EventType.VISIBILITYCHANGE) :
        goog.events.EventType.VISIBILITYCHANGE;
  } else {
    return null;
  }
});


/**
 * @return {?string} The browser-specific document.hidden property.  Memoized
 *     for performance.
 * @private
 */
goog.labs.dom.PageVisibilityMonitor.prototype.getHiddenPropertyName_ =
    goog.memoize(function() {
      'use strict';
      return goog.dom.vendor.getPrefixedPropertyName(
          'hidden',
          /** @type {!goog.labs.dom.PageVisibilityMonitor} */
          (this).domHelper_.getDocument());
    });


/**
 * @return {boolean} Whether the visibility API is prefixed.
 * @private
 */
goog.labs.dom.PageVisibilityMonitor.prototype.isPrefixed_ = function() {
  'use strict';
  return this.getHiddenPropertyName_() != 'hidden';
};


/**
 * @return {?string} The browser-specific document.visibilityState property.
 *     Memoized for performance.
 * @private
 */
goog.labs.dom.PageVisibilityMonitor.prototype.getVisibilityStatePropertyName_ =
    goog.memoize(function() {
      'use strict';
      return goog.dom.vendor.getPrefixedPropertyName(
          'visibilityState',
          /** @type {!goog.labs.dom.PageVisibilityMonitor} */
          (this).domHelper_.getDocument());
    });


/**
 * @return {boolean} Whether the visibility API is supported.
 */
goog.labs.dom.PageVisibilityMonitor.prototype.isSupported = function() {
  'use strict';
  return !!this.getHiddenPropertyName_();
};


/**
 * @return {boolean} Whether the page is visible.
 */
goog.labs.dom.PageVisibilityMonitor.prototype.isHidden = function() {
  'use strict';
  return !!this.domHelper_.getDocument()[this.getHiddenPropertyName_()];
};


/**
 * @return {?goog.labs.dom.PageVisibilityState} The page visibility state, or
 *     null if not supported.
 */
goog.labs.dom.PageVisibilityMonitor.prototype.getVisibilityState = function() {
  'use strict';
  if (!this.isSupported()) {
    return null;
  }
  return this.domHelper_.getDocument()[this.getVisibilityStatePropertyName_()];
};


/**
 * Handles the events on the element.
 * @param {goog.events.BrowserEvent} e The underlying browser event.
 * @private
 */
goog.labs.dom.PageVisibilityMonitor.prototype.handleChange_ = function(e) {
  'use strict';
  var state = this.getVisibilityState();
  var visibilityEvent = new goog.labs.dom.PageVisibilityEvent(
      this.isHidden(),
      /** @type {goog.labs.dom.PageVisibilityState} */ (state));
  this.dispatchEvent(visibilityEvent);
};


/** @override */
goog.labs.dom.PageVisibilityMonitor.prototype.disposeInternal = function() {
  'use strict';
  goog.events.unlistenByKey(this.eventKey_);
  goog.labs.dom.PageVisibilityMonitor.base(this, 'disposeInternal');
};