browser-data.js 8.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199
  1. /**
  2. * @license
  3. * Copyright 2023 Google Inc.
  4. * SPDX-License-Identifier: Apache-2.0
  5. */
  6. import * as chromeHeadlessShell from './chrome-headless-shell.js';
  7. import * as chrome from './chrome.js';
  8. import * as chromedriver from './chromedriver.js';
  9. import * as chromium from './chromium.js';
  10. import * as firefox from './firefox.js';
  11. import { Browser, BrowserPlatform, BrowserTag, ChromeReleaseChannel, } from './types.js';
  12. export const downloadUrls = {
  13. [Browser.CHROMEDRIVER]: chromedriver.resolveDownloadUrl,
  14. [Browser.CHROMEHEADLESSSHELL]: chromeHeadlessShell.resolveDownloadUrl,
  15. [Browser.CHROME]: chrome.resolveDownloadUrl,
  16. [Browser.CHROMIUM]: chromium.resolveDownloadUrl,
  17. [Browser.FIREFOX]: firefox.resolveDownloadUrl,
  18. };
  19. export const downloadPaths = {
  20. [Browser.CHROMEDRIVER]: chromedriver.resolveDownloadPath,
  21. [Browser.CHROMEHEADLESSSHELL]: chromeHeadlessShell.resolveDownloadPath,
  22. [Browser.CHROME]: chrome.resolveDownloadPath,
  23. [Browser.CHROMIUM]: chromium.resolveDownloadPath,
  24. [Browser.FIREFOX]: firefox.resolveDownloadPath,
  25. };
  26. export const executablePathByBrowser = {
  27. [Browser.CHROMEDRIVER]: chromedriver.relativeExecutablePath,
  28. [Browser.CHROMEHEADLESSSHELL]: chromeHeadlessShell.relativeExecutablePath,
  29. [Browser.CHROME]: chrome.relativeExecutablePath,
  30. [Browser.CHROMIUM]: chromium.relativeExecutablePath,
  31. [Browser.FIREFOX]: firefox.relativeExecutablePath,
  32. };
  33. export const versionComparators = {
  34. [Browser.CHROMEDRIVER]: chromedriver.compareVersions,
  35. [Browser.CHROMEHEADLESSSHELL]: chromeHeadlessShell.compareVersions,
  36. [Browser.CHROME]: chrome.compareVersions,
  37. [Browser.CHROMIUM]: chromium.compareVersions,
  38. [Browser.FIREFOX]: firefox.compareVersions,
  39. };
  40. export { Browser, BrowserPlatform, ChromeReleaseChannel };
  41. /**
  42. * @internal
  43. */
  44. async function resolveBuildIdForBrowserTag(browser, platform, tag) {
  45. switch (browser) {
  46. case Browser.FIREFOX:
  47. switch (tag) {
  48. case BrowserTag.LATEST:
  49. return await firefox.resolveBuildId(firefox.FirefoxChannel.NIGHTLY);
  50. case BrowserTag.BETA:
  51. return await firefox.resolveBuildId(firefox.FirefoxChannel.BETA);
  52. case BrowserTag.NIGHTLY:
  53. return await firefox.resolveBuildId(firefox.FirefoxChannel.NIGHTLY);
  54. case BrowserTag.DEVEDITION:
  55. return await firefox.resolveBuildId(firefox.FirefoxChannel.DEVEDITION);
  56. case BrowserTag.STABLE:
  57. return await firefox.resolveBuildId(firefox.FirefoxChannel.STABLE);
  58. case BrowserTag.ESR:
  59. return await firefox.resolveBuildId(firefox.FirefoxChannel.ESR);
  60. case BrowserTag.CANARY:
  61. case BrowserTag.DEV:
  62. throw new Error(`${tag.toUpperCase()} is not available for Firefox`);
  63. }
  64. case Browser.CHROME: {
  65. switch (tag) {
  66. case BrowserTag.LATEST:
  67. return await chrome.resolveBuildId(ChromeReleaseChannel.CANARY);
  68. case BrowserTag.BETA:
  69. return await chrome.resolveBuildId(ChromeReleaseChannel.BETA);
  70. case BrowserTag.CANARY:
  71. return await chrome.resolveBuildId(ChromeReleaseChannel.CANARY);
  72. case BrowserTag.DEV:
  73. return await chrome.resolveBuildId(ChromeReleaseChannel.DEV);
  74. case BrowserTag.STABLE:
  75. return await chrome.resolveBuildId(ChromeReleaseChannel.STABLE);
  76. case BrowserTag.NIGHTLY:
  77. case BrowserTag.DEVEDITION:
  78. case BrowserTag.ESR:
  79. throw new Error(`${tag.toUpperCase()} is not available for Chrome`);
  80. }
  81. }
  82. case Browser.CHROMEDRIVER: {
  83. switch (tag) {
  84. case BrowserTag.LATEST:
  85. case BrowserTag.CANARY:
  86. return await chromedriver.resolveBuildId(ChromeReleaseChannel.CANARY);
  87. case BrowserTag.BETA:
  88. return await chromedriver.resolveBuildId(ChromeReleaseChannel.BETA);
  89. case BrowserTag.DEV:
  90. return await chromedriver.resolveBuildId(ChromeReleaseChannel.DEV);
  91. case BrowserTag.STABLE:
  92. return await chromedriver.resolveBuildId(ChromeReleaseChannel.STABLE);
  93. case BrowserTag.NIGHTLY:
  94. case BrowserTag.DEVEDITION:
  95. case BrowserTag.ESR:
  96. throw new Error(`${tag.toUpperCase()} is not available for ChromeDriver`);
  97. }
  98. }
  99. case Browser.CHROMEHEADLESSSHELL: {
  100. switch (tag) {
  101. case BrowserTag.LATEST:
  102. case BrowserTag.CANARY:
  103. return await chromeHeadlessShell.resolveBuildId(ChromeReleaseChannel.CANARY);
  104. case BrowserTag.BETA:
  105. return await chromeHeadlessShell.resolveBuildId(ChromeReleaseChannel.BETA);
  106. case BrowserTag.DEV:
  107. return await chromeHeadlessShell.resolveBuildId(ChromeReleaseChannel.DEV);
  108. case BrowserTag.STABLE:
  109. return await chromeHeadlessShell.resolveBuildId(ChromeReleaseChannel.STABLE);
  110. case BrowserTag.NIGHTLY:
  111. case BrowserTag.DEVEDITION:
  112. case BrowserTag.ESR:
  113. throw new Error(`${tag} is not available for chrome-headless-shell`);
  114. }
  115. }
  116. case Browser.CHROMIUM:
  117. switch (tag) {
  118. case BrowserTag.LATEST:
  119. return await chromium.resolveBuildId(platform);
  120. case BrowserTag.NIGHTLY:
  121. case BrowserTag.CANARY:
  122. case BrowserTag.DEV:
  123. case BrowserTag.DEVEDITION:
  124. case BrowserTag.BETA:
  125. case BrowserTag.STABLE:
  126. case BrowserTag.ESR:
  127. throw new Error(`${tag} is not supported for Chromium. Use 'latest' instead.`);
  128. }
  129. }
  130. }
  131. /**
  132. * @public
  133. */
  134. export async function resolveBuildId(browser, platform, tag) {
  135. const browserTag = tag;
  136. if (Object.values(BrowserTag).includes(browserTag)) {
  137. return await resolveBuildIdForBrowserTag(browser, platform, browserTag);
  138. }
  139. switch (browser) {
  140. case Browser.FIREFOX:
  141. return tag;
  142. case Browser.CHROME:
  143. const chromeResult = await chrome.resolveBuildId(tag);
  144. if (chromeResult) {
  145. return chromeResult;
  146. }
  147. return tag;
  148. case Browser.CHROMEDRIVER:
  149. const chromeDriverResult = await chromedriver.resolveBuildId(tag);
  150. if (chromeDriverResult) {
  151. return chromeDriverResult;
  152. }
  153. return tag;
  154. case Browser.CHROMEHEADLESSSHELL:
  155. const chromeHeadlessShellResult = await chromeHeadlessShell.resolveBuildId(tag);
  156. if (chromeHeadlessShellResult) {
  157. return chromeHeadlessShellResult;
  158. }
  159. return tag;
  160. case Browser.CHROMIUM:
  161. return tag;
  162. }
  163. }
  164. /**
  165. * @public
  166. */
  167. export async function createProfile(browser, opts) {
  168. switch (browser) {
  169. case Browser.FIREFOX:
  170. return await firefox.createProfile(opts);
  171. case Browser.CHROME:
  172. case Browser.CHROMIUM:
  173. throw new Error(`Profile creation is not support for ${browser} yet`);
  174. }
  175. }
  176. /**
  177. * @public
  178. */
  179. export function resolveSystemExecutablePath(browser, platform, channel) {
  180. switch (browser) {
  181. case Browser.CHROMEDRIVER:
  182. case Browser.CHROMEHEADLESSSHELL:
  183. case Browser.FIREFOX:
  184. case Browser.CHROMIUM:
  185. throw new Error(`System browser detection is not supported for ${browser} yet.`);
  186. case Browser.CHROME:
  187. return chrome.resolveSystemExecutablePath(platform, channel);
  188. }
  189. }
  190. /**
  191. * Returns a version comparator for the given browser that can be used to sort
  192. * browser versions.
  193. *
  194. * @public
  195. */
  196. export function getVersionComparator(browser) {
  197. return versionComparators[browser];
  198. }
  199. //# sourceMappingURL=browser-data.js.map