initial commit

2026-06-25 21:30:32 +00:00
commit 328faf6251
220 changed files with 162103 additions and 0 deletions
@@ -0,0 +1,181 @@
+/**
+ * @license
+ * Copyright The Closure Library Authors.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Closure user agent platform detection.
+ * @see <a href="http://www.useragentstring.com/">User agent strings</a>
+ * For more information on browser brand, rendering engine, or device see the
+ * other sub-namespaces in goog.labs.userAgent (browser, engine, and device
+ * respectively).
+ */
+
+goog.module('goog.labs.userAgent.platform');
+goog.module.declareLegacyNamespace();
+
+const googString = goog.require('goog.string.internal');
+const util = goog.require('goog.labs.userAgent.util');
+
+/**
+ * @return {boolean} Whether the platform is Android.
+ */
+function isAndroid() {
+  return util.matchUserAgent('Android');
+}
+
+/**
+ * @return {boolean} Whether the platform is iPod.
+ */
+function isIpod() {
+  return util.matchUserAgent('iPod');
+}
+
+/**
+ * @return {boolean} Whether the platform is iPhone.
+ */
+function isIphone() {
+  return util.matchUserAgent('iPhone') && !util.matchUserAgent('iPod') &&
+      !util.matchUserAgent('iPad');
+}
+
+/**
+ * Returns whether the platform is iPad.
+ * Note that iPadOS 13+ spoofs macOS Safari by default in its user agent, and in
+ * this scenario the platform will not be recognized as iPad. If you must have
+ * iPad-specific behavior, use
+ * {@link goog.labs.userAgent.extra.isSafariDesktopOnMobile}.
+ * @return {boolean} Whether the platform is iPad.
+ */
+function isIpad() {
+  return util.matchUserAgent('iPad');
+}
+
+/**
+ * Returns whether the platform is iOS.
+ * Note that iPadOS 13+ spoofs macOS Safari by default in its user agent, and in
+ * this scenario the platform will not be recognized as iOS. If you must have
+ * iPad-specific behavior, use
+ * {@link goog.labs.userAgent.extra.isSafariDesktopOnMobile}.
+ * @return {boolean} Whether the platform is iOS.
+ */
+function isIos() {
+  return isIphone() || isIpad() || isIpod();
+}
+
+/**
+ * @return {boolean} Whether the platform is Mac.
+ */
+function isMacintosh() {
+  return util.matchUserAgent('Macintosh');
+}
+
+/**
+ * Note: ChromeOS is not considered to be Linux as it does not report itself
+ * as Linux in the user agent string.
+ * @return {boolean} Whether the platform is Linux.
+ */
+function isLinux() {
+  return util.matchUserAgent('Linux');
+}
+
+/**
+ * @return {boolean} Whether the platform is Windows.
+ */
+function isWindows() {
+  return util.matchUserAgent('Windows');
+}
+
+/**
+ * @return {boolean} Whether the platform is ChromeOS.
+ */
+function isChromeOS() {
+  return util.matchUserAgent('CrOS');
+}
+
+/**
+ * @return {boolean} Whether the platform is Chromecast.
+ */
+function isChromecast() {
+  return util.matchUserAgent('CrKey');
+}
+
+/**
+ * @return {boolean} Whether the platform is KaiOS.
+ */
+function isKaiOS() {
+  return util.matchUserAgentIgnoreCase('KaiOS');
+}
+
+/**
+ * The version of the platform. We only determine the version for Windows,
+ * Mac, and Chrome OS. It doesn't make much sense on Linux. For Windows, we only
+ * look at the NT version. Non-NT-based versions (e.g. 95, 98, etc.) are given
+ * version 0.0.
+ *
+ * @return {string} The platform version or empty string if version cannot be
+ *     determined.
+ */
+function getVersion() {
+  const userAgentString = util.getUserAgent();
+  let version = '', re;
+  if (isWindows()) {
+    re = /Windows (?:NT|Phone) ([0-9.]+)/;
+    const match = re.exec(userAgentString);
+    if (match) {
+      version = match[1];
+    } else {
+      version = '0.0';
+    }
+  } else if (isIos()) {
+    re = /(?:iPhone|iPod|iPad|CPU)\s+OS\s+(\S+)/;
+    const match = re.exec(userAgentString);
+    // Report the version as x.y.z and not x_y_z
+    version = match && match[1].replace(/_/g, '.');
+  } else if (isMacintosh()) {
+    re = /Mac OS X ([0-9_.]+)/;
+    const match = re.exec(userAgentString);
+    // Note: some old versions of Camino do not report an OSX version.
+    // Default to 10.
+    version = match ? match[1].replace(/_/g, '.') : '10';
+  } else if (isKaiOS()) {
+    re = /(?:KaiOS)\/(\S+)/i;
+    const match = re.exec(userAgentString);
+    version = match && match[1];
+  } else if (isAndroid()) {
+    re = /Android\s+([^\);]+)(\)|;)/;
+    const match = re.exec(userAgentString);
+    version = match && match[1];
+  } else if (isChromeOS()) {
+    re = /(?:CrOS\s+(?:i686|x86_64)\s+([0-9.]+))/;
+    const match = re.exec(userAgentString);
+    version = match && match[1];
+  }
+  return version || '';
+}
+
+/**
+ * @param {string|number} version The version to check.
+ * @return {boolean} Whether the browser version is higher or the same as the
+ *     given version.
+ */
+function isVersionOrHigher(version) {
+  return googString.compareVersions(getVersion(), version) >= 0;
+}
+
+exports = {
+  getVersion,
+  isAndroid,
+  isChromeOS,
+  isChromecast,
+  isIos,
+  isIpad,
+  isIphone,
+  isIpod,
+  isKaiOS,
+  isLinux,
+  isMacintosh,
+  isVersionOrHigher,
+  isWindows,
+};