Debian Codegraph @

closure-library/closure/goog/useragent/product_isversion.js

raw
1 // Copyright 2009 The Closure Library Authors. All Rights Reserved.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS-IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14
15 /**
16 * @fileoverview Functions for understanding the version of the browser.
17 * This is pulled out of product.js to ensure that only builds that need
18 * this functionality actually get it, without having to rely on the compiler
19 * to strip out unneeded pieces.
20 *
21 * TODO(nnaze): Move to more appropriate filename/namespace.
22 *
23 */
24
25
26 goog.provide('goog.userAgent.product.isVersion');
27
28
29 goog.require('goog.labs.userAgent.platform');
30 goog.require('goog.string');
31 goog.require('goog.userAgent');
32 goog.require('goog.userAgent.product');
33
34
35 /**
36 * @return {string} The string that describes the version number of the user
37 * agent product. This is a string rather than a number because it may
38 * contain 'b', 'a', and so on.
39 * @private
40 */
41 goog.userAgent.product.determineVersion_ = function() {
42 // All browsers have different ways to detect the version and they all have
43 // different naming schemes.
44
45 if (goog.userAgent.product.FIREFOX) {
46 // Firefox/2.0.0.1 or Firefox/3.5.3
47 return goog.userAgent.product.getFirstRegExpGroup_(/Firefox\/([0-9.]+)/);
48 }
49
50 if (goog.userAgent.product.IE || goog.userAgent.product.EDGE ||
51 goog.userAgent.product.OPERA) {
52 return goog.userAgent.VERSION;
53 }
54
55 if (goog.userAgent.product.CHROME) {
56 if (goog.labs.userAgent.platform.isIos()) {
57 // CriOS/56.0.2924.79
58 return goog.userAgent.product.getFirstRegExpGroup_(/CriOS\/([0-9.]+)/);
59 }
60 // Chrome/4.0.223.1
61 return goog.userAgent.product.getFirstRegExpGroup_(/Chrome\/([0-9.]+)/);
62 }
63
64 // This replicates legacy logic, which considered Safari and iOS to be
65 // different products.
66 if (goog.userAgent.product.SAFARI && !goog.labs.userAgent.platform.isIos()) {
67 // Version/5.0.3
68 //
69 // NOTE: Before version 3, Safari did not report a product version number.
70 // The product version number for these browsers will be the empty string.
71 // They may be differentiated by WebKit version number in goog.userAgent.
72 return goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);
73 }
74
75 if (goog.userAgent.product.IPHONE || goog.userAgent.product.IPAD) {
76 // Mozilla/5.0 (iPod; U; CPU like Mac OS X; en) AppleWebKit/420.1
77 // (KHTML, like Gecko) Version/3.0 Mobile/3A100a Safari/419.3
78 // Version is the browser version, Mobile is the build number. We combine
79 // the version string with the build number: 3.0.3A100a for the example.
80 var arr =
81 goog.userAgent.product.execRegExp_(/Version\/(\S+).*Mobile\/(\S+)/);
82 if (arr) {
83 return arr[1] + '.' + arr[2];
84 }
85 } else if (goog.userAgent.product.ANDROID) {
86 // Mozilla/5.0 (Linux; U; Android 0.5; en-us) AppleWebKit/522+
87 // (KHTML, like Gecko) Safari/419.3
88 //
89 // Mozilla/5.0 (Linux; U; Android 1.0; en-us; dream) AppleWebKit/525.10+
90 // (KHTML, like Gecko) Version/3.0.4 Mobile Safari/523.12.2
91 //
92 // Prefer Version number if present, else make do with the OS number
93 var version =
94 goog.userAgent.product.getFirstRegExpGroup_(/Android\s+([0-9.]+)/);
95 if (version) {
96 return version;
97 }
98
99 return goog.userAgent.product.getFirstRegExpGroup_(/Version\/([0-9.]+)/);
100 }
101
102 return '';
103 };
104
105
106 /**
107 * Return the first group of the given regex.
108 * @param {!RegExp} re Regular expression with at least one group.
109 * @return {string} Contents of the first group or an empty string if no match.
110 * @private
111 */
112 goog.userAgent.product.getFirstRegExpGroup_ = function(re) {
113 var arr = goog.userAgent.product.execRegExp_(re);
114 return arr ? arr[1] : '';
115 };
116
117
118 /**
119 * Run regexp's exec() on the userAgent string.
120 * @param {!RegExp} re Regular expression.
121 * @return {?Array<?>} A result array, or null for no match.
122 * @private
123 */
124 goog.userAgent.product.execRegExp_ = function(re) {
125 return re.exec(goog.userAgent.getUserAgentString());
126 };
127
128
129 /**
130 * The version of the user agent. This is a string because it might contain
131 * 'b' (as in beta) as well as multiple dots.
132 * @type {string}
133 */
134 goog.userAgent.product.VERSION = goog.userAgent.product.determineVersion_();
135
136
137 /**
138 * Whether the user agent product version is higher or the same as the given
139 * version.
140 *
141 * @param {string|number} version The version to check.
142 * @return {boolean} Whether the user agent product version is higher or the
143 * same as the given version.
144 */
145 goog.userAgent.product.isVersion = function(version) {
146 return goog.string.compareVersions(goog.userAgent.product.VERSION, version) >=
147 0;
148 };