device.js

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

/**
 * @fileoverview Closure user device detection (based on user agent).
 * @see http://en.wikipedia.org/wiki/User_agent
 * For more information on browser brand, platform, or engine see the other
 * sub-namespaces in goog.labs.userAgent (browser, platform, and engine).
 */

goog.provide('goog.labs.userAgent.device');

goog.require('goog.labs.userAgent');
goog.require('goog.labs.userAgent.util');

/**
 * Currently we detect the iPhone, iPod and Android mobiles (devices that have
 * both Android and Mobile in the user agent string).
 *
 * @return {boolean} Whether the user is using a mobile device.
 */
goog.labs.userAgent.device.isMobile = function() {
  'use strict';
  if (goog.labs.userAgent.util.ASSUME_CLIENT_HINTS_SUPPORT ||
      goog.labs.userAgent.useClientHints() &&
          goog.labs.userAgent.util.getUserAgentData()) {
    return goog.labs.userAgent.util.getUserAgentData().mobile;
  }
  return !goog.labs.userAgent.device.isTablet() &&
      (goog.labs.userAgent.util.matchUserAgent('iPod') ||
       goog.labs.userAgent.util.matchUserAgent('iPhone') ||
       goog.labs.userAgent.util.matchUserAgent('Android') ||
       goog.labs.userAgent.util.matchUserAgent('IEMobile'));
};


/**
 * Currently we detect Kindle Fire, iPad, and Android tablets (devices that have
 * Android but not Mobile in the user agent string).
 *
 * @return {boolean} Whether the user is using a tablet.
 */
goog.labs.userAgent.device.isTablet = function() {
  'use strict';
  if (goog.labs.userAgent.util.ASSUME_CLIENT_HINTS_SUPPORT ||
      (goog.labs.userAgent.useClientHints() &&
       goog.labs.userAgent.util.getUserAgentData())) {
    return !goog.labs.userAgent.util.getUserAgentData().mobile &&
        (goog.labs.userAgent.util.matchUserAgent('iPad') ||
         goog.labs.userAgent.util.matchUserAgent('Android') ||
         goog.labs.userAgent.util.matchUserAgent('Silk'));
  }
  return goog.labs.userAgent.util.matchUserAgent('iPad') ||
      (goog.labs.userAgent.util.matchUserAgent('Android') &&
       !goog.labs.userAgent.util.matchUserAgent('Mobile')) ||
      goog.labs.userAgent.util.matchUserAgent('Silk');
};


/**
 * @return {boolean} Whether the user is using a desktop computer (which we
 *     assume to be the case if they are not using either a mobile or tablet
 *     device).
 */
goog.labs.userAgent.device.isDesktop = function() {
  'use strict';
  return !goog.labs.userAgent.device.isMobile() &&
      !goog.labs.userAgent.device.isTablet();
};