@jsenv/core 25.6.2 → 27.0.0-alpha.0

package/src/internal/browser_detection/browser_detection.js

@@ -1,68 +0,0 @@
-// https://github.com/Ahmdrza/detect-browser/blob/26254f85cf92795655a983bfd759d85f3de850c6/detect-browser.js#L1
-// https://github.com/lancedikson/bowser/blob/master/src/parser-browsers.js#L1
-
-import { detectFromUserAgentData } from "./user_agent_data.js"
-import { detectAndroid } from "./detectAndroid.js"
-import { detectInternetExplorer } from "./detectInternetExplorer.js"
-import { detectOpera } from "./detectOpera.js"
-import { detectEdge } from "./detectEdge.js"
-import { detectFirefox } from "./detectFirefox.js"
-import { detectChrome } from "./detectChrome.js"
-import { detectSafari } from "./detectSafari.js"
-import { detectElectron } from "./detectElectron.js"
-import { detectIOS } from "./detectIOS.js"
-
-const detectorCompose = (detectors) => () => {
-  let i = 0
-  while (i < detectors.length) {
-    const detector = detectors[i]
-    i++
-    const result = detector()
-    if (result) {
-      return result
-    }
-  }
-  return null
-}
-
-const detector = detectorCompose([
-  detectFromUserAgentData, // keep this first
-  detectOpera,
-  detectInternetExplorer,
-  detectEdge,
-  detectFirefox,
-  detectChrome,
-  detectSafari,
-  detectElectron,
-  detectIOS,
-  detectAndroid,
-])
-
-export const detectBrowser = () => {
-  const { name = "other", version = "unknown" } = detector() || {}
-
-  return {
-    name: normalizeName(name),
-    version: normalizeVersion(version),
-  }
-}
-
-const normalizeName = (name) => {
-  return name.toLowerCase()
-}
-
-const normalizeVersion = (version) => {
-  if (version.indexOf(".") > -1) {
-    const parts = version.split(".")
-    // remove extraneous .
-    return parts.slice(0, 3).join(".")
-  }
-
-  if (version.indexOf("_") > -1) {
-    const parts = version.split("_")
-    // remove extraneous _
-    return parts.slice(0, 3).join("_")
-  }
-
-  return version
-}

package/src/internal/browser_detection/detectAndroid.js

@@ -1,13 +0,0 @@
-import { firstMatch } from "./util.js"
-
-export const detectAndroid = () => navigatorToBrowser(window.navigator)
-
-const navigatorToBrowser = ({ userAgent, appVersion }) => {
-  if (/(android)/i.test(userAgent)) {
-    return {
-      name: "android",
-      version: firstMatch(/Android (\d+(\.?_?\d+)+)/i, appVersion),
-    }
-  }
-  return null
-}

package/src/internal/browser_detection/detectChrome.js

@@ -1,28 +0,0 @@
-import { userAgentToVersion, firstMatch } from "./util.js"
-
-export const detectChrome = () => {
-  return userAgentToBrowser(window.navigator.userAgent)
-}
-
-const userAgentToBrowser = (userAgent) => {
-  if (/chromium/i.test(userAgent)) {
-    return {
-      name: "chrome",
-      version:
-        firstMatch(/(?:chromium)[\s/](\d+(\.?_?\d+)+)/i, userAgent) ||
-        userAgentToVersion(userAgent),
-    }
-  }
-
-  if (/chrome|crios|crmo/i.test(userAgent)) {
-    return {
-      name: "chrome",
-      version: firstMatch(
-        /(?:chrome|crios|crmo)\/(\d+(\.?_?\d+)+)/i,
-        userAgent,
-      ),
-    }
-  }
-
-  return null
-}

package/src/internal/browser_detection/detectEdge.js

@@ -1,13 +0,0 @@
-import { secondMatch } from "./util.js"
-
-export const detectEdge = () => userAgentToBrowser(window.navigator.userAgent)
-
-const userAgentToBrowser = (userAgent) => {
-  if (/edg([ea]|ios)/i.test(userAgent)) {
-    return {
-      name: "edge",
-      version: secondMatch(/edg([ea]|ios)\/(\d+(\.?_?\d+)+)/i, userAgent),
-    }
-  }
-  return null
-}

package/src/internal/browser_detection/detectElectron.js

@@ -1 +0,0 @@
-export const detectElectron = () => null // TODO

package/src/internal/browser_detection/detectFirefox.js

@@ -1,17 +0,0 @@
-import { firstMatch } from "./util.js"
-
-export const detectFirefox = () =>
-  userAgentToBrowser(window.navigator.userAgent)
-
-const userAgentToBrowser = (userAgent) => {
-  if (/firefox|iceweasel|fxios/i.test(userAgent)) {
-    return {
-      name: "firefox",
-      version: firstMatch(
-        /(?:firefox|iceweasel|fxios)[\s/](\d+(\.?_?\d+)+)/i,
-        userAgent,
-      ),
-    }
-  }
-  return null
-}

package/src/internal/browser_detection/detectIOS.js

@@ -1,19 +0,0 @@
-import { firstMatch } from "./util.js"
-
-export const detectIOS = () => navigatorToBrowser(window.navigator)
-
-const navigatorToBrowser = ({ userAgent, appVersion }) => {
-  if (/iPhone;/.test(userAgent)) {
-    return {
-      name: "ios",
-      version: firstMatch(/OS (\d+(\.?_?\d+)+)/i, appVersion),
-    }
-  }
-  if (/iPad;/.test(userAgent)) {
-    return {
-      name: "ios",
-      version: firstMatch(/OS (\d+(\.?_?\d+)+)/i, appVersion),
-    }
-  }
-  return null
-}

package/src/internal/browser_detection/detectInternetExplorer.js

@@ -1,14 +0,0 @@
-import { firstMatch } from "./util.js"
-
-export const detectInternetExplorer = () =>
-  userAgentToBrowser(window.navigator.userAgent)
-
-const userAgentToBrowser = (userAgent) => {
-  if (/msie|trident/i.test(userAgent)) {
-    return {
-      name: "ie",
-      version: firstMatch(/(?:msie |rv:)(\d+(\.?_?\d+)+)/i, userAgent),
-    }
-  }
-  return null
-}

package/src/internal/browser_detection/detectOpera.js

@@ -1,27 +0,0 @@
-import { firstMatch, userAgentToVersion } from "./util.js"
-
-export const detectOpera = () => userAgentToBrowser(window.navigator.userAgent)
-
-const userAgentToBrowser = (userAgent) => {
-  // opera below 13
-  if (/opera/i.test(userAgent)) {
-    return {
-      name: "opera",
-      version:
-        userAgentToVersion(userAgent) ||
-        firstMatch(/(?:opera)[\s/](\d+(\.?_?\d+)+)/i, userAgent),
-    }
-  }
-
-  // opera above 13
-  if (/opr\/|opios/i.test(userAgent)) {
-    return {
-      name: "opera",
-      version:
-        firstMatch(/(?:opr|opios)[\s/](\S+)/i, userAgent) ||
-        userAgentToVersion(userAgent),
-    }
-  }
-
-  return null
-}

package/src/internal/browser_detection/detectSafari.js

@@ -1,13 +0,0 @@
-import { userAgentToVersion } from "./util.js"
-
-export const detectSafari = () => userAgentToBrowser(window.navigator.userAgent)
-
-const userAgentToBrowser = (userAgent) => {
-  if (/safari|applewebkit/i.test(userAgent)) {
-    return {
-      name: "safari",
-      version: userAgentToVersion(userAgent),
-    }
-  }
-  return null
-}

package/src/internal/browser_detection/user_agent_data.js

@@ -1,26 +0,0 @@
-/*
- * Prefer window.navigator.userAgentData before resorting to
- * window.navigator.userAgent because of
- * https://blog.chromium.org/2021/09/user-agent-reduction-origin-trial-and-dates.html
- */
-
-export const detectFromUserAgentData = () => {
-  const { userAgentData } = window.navigator
-  if (!userAgentData) {
-    return null
-  }
-
-  const { brands } = userAgentData
-  let i = 0
-  while (i < brands.length) {
-    const { brand, version } = brands[i]
-    i++
-    if (brand === "chromium" || brand === "Google Chrome") {
-      return {
-        name: "chrome",
-        version,
-      }
-    }
-  }
-  return null
-}

package/src/internal/browser_detection/util.js

@@ -1,13 +0,0 @@
-export const firstMatch = (regexp, string) => {
-  const match = string.match(regexp)
-  return match && match.length > 0 ? match[1] || undefined : undefined
-}
-
-export const secondMatch = (regexp, string) => {
-  const match = string.match(regexp)
-  return match && match.length > 1 ? match[2] || undefined : undefined
-}
-
-export const userAgentToVersion = (userAgent) => {
-  return firstMatch(/version\/(\d+(\.?_?\d+)+)/i, userAgent) || undefined
-}

package/src/internal/browser_launcher/browser_runtime_profile.js

@@ -1,81 +0,0 @@
-export const getBrowserRuntimeProfile = async ({
-  page,
-  runtime,
-  compileServerId,
-  coverageHandledFromOutside,
-  forceSource,
-  forceCompilation,
-}) => {
-  const cache = cacheFromParams({
-    runtime,
-    compileServerId,
-    coverageHandledFromOutside,
-    forceSource,
-    forceCompilation,
-  })
-  const entry = cache.read()
-  if (entry) {
-    return entry
-  }
-  const browserRuntimeProfile = await page.evaluate(
-    /* eslint-disable no-undef */
-    /* istanbul ignore next */
-    async ({ coverageHandledFromOutside, forceSource, forceCompilation }) => {
-      await window.readyPromise
-      const runtimeProfile = await window.scanBrowserRuntimeFeatures({
-        coverageHandledFromOutside,
-        forceSource,
-        forceCompilation,
-      })
-      return runtimeProfile
-    },
-    /* eslint-enable no-undef */
-    { coverageHandledFromOutside, forceSource, forceCompilation },
-  )
-  cache.write(browserRuntimeProfile)
-  return browserRuntimeProfile
-}
-
-let currentCacheParams
-let currentCacheValue
-const cacheFromParams = ({
-  runtime,
-  compileServerId,
-  coverageHandledFromOutside,
-  forceSource,
-  forceCompilation,
-}) => {
-  const params = {
-    compileServerId,
-    coverageHandledFromOutside,
-    forceSource,
-    forceCompilation,
-  }
-  const runtimeLabel = `${runtime.name}/${runtime.version}`
-  if (!currentCacheParams) {
-    currentCacheParams = params
-    currentCacheValue = {}
-    return {
-      read: () => null,
-      write: (value) => {
-        currentCacheValue[runtimeLabel] = value
-      },
-    }
-  }
-  if (JSON.stringify(currentCacheParams) !== JSON.stringify(params)) {
-    return {
-      read: () => null,
-      write: (value) => {
-        currentCacheParams = params
-        currentCacheValue = {}
-        currentCacheValue[runtimeLabel] = value
-      },
-    }
-  }
-  return {
-    read: () => currentCacheValue[runtimeLabel],
-    write: (value) => {
-      currentCacheValue[runtimeLabel] = value
-    },
-  }
-}

package/src/internal/browser_launcher/executeHtmlFile.js

@@ -1,354 +0,0 @@
-import {
-  resolveUrl,
-  assertFilePresence,
-  urlToRelativeUrl,
-  urlToExtension,
-} from "@jsenv/filesystem"
-
-import { COMPILE_PROXY_BUILD_URL } from "@jsenv/core/dist/build_manifest.js"
-import { filterV8Coverage } from "@jsenv/core/src/internal/executing/coverage_utils/v8_coverage_from_directory.js"
-import { composeTwoFileByFileIstanbulCoverages } from "@jsenv/core/src/internal/executing/coverage_utils/istanbul_coverage_composition.js"
-import { evalSource } from "../node_runtime/evalSource.js"
-import { escapeRegexpSpecialCharacters } from "../escapeRegexpSpecialCharacters.js"
-import { getBrowserRuntimeProfile } from "./browser_runtime_profile.js"
-
-export const executeHtmlFile = async (
-  fileRelativeUrl,
-  {
-    runtime,
-    executeOperation,
-    projectDirectoryUrl,
-    compileServerOrigin,
-    compileServerId,
-    jsenvDirectoryRelativeUrl,
-    page,
-
-    // measurePerformance,
-    collectPerformance,
-    collectCoverage,
-    coverageIgnorePredicate,
-    coverageForceIstanbul,
-    coveragePlaywrightAPIAvailable,
-    transformErrorHook,
-    forceSource,
-    forceCompilation,
-  },
-) => {
-  const fileUrl = resolveUrl(fileRelativeUrl, projectDirectoryUrl)
-  if (urlToExtension(fileUrl) !== ".html") {
-    throw new Error(
-      `the file to execute must use .html extension, received ${fileRelativeUrl}.`,
-    )
-  }
-
-  await assertFilePresence(fileUrl)
-
-  const compileProxyProjectRelativeUrl = urlToRelativeUrl(
-    COMPILE_PROXY_BUILD_URL,
-    projectDirectoryUrl,
-  )
-  const compileProxyClientUrl = resolveUrl(
-    compileProxyProjectRelativeUrl,
-    compileServerOrigin,
-  )
-  executeOperation.throwIfAborted()
-  await page.goto(compileProxyClientUrl)
-  executeOperation.throwIfAborted()
-
-  const coverageHandledFromOutside =
-    coveragePlaywrightAPIAvailable && !coverageForceIstanbul
-  const browserRuntimeProfile = await getBrowserRuntimeProfile({
-    page,
-    compileServerId,
-    runtime,
-    // js coverage
-    // When instrumentation CAN be handed by playwright
-    // https://playwright.dev/docs/api/class-chromiumcoverage#chromiumcoveragestartjscoverageoptions
-    // coverageHandledFromOutside is true and "transform-instrument" becomes non mandatory
-    coverageHandledFromOutside,
-    forceSource,
-    forceCompilation,
-  })
-
-  try {
-    let executionResult
-    const { compileId } = browserRuntimeProfile
-    executeOperation.throwIfAborted()
-    if (compileId) {
-      executionResult = await executeCompiledVersion({
-        projectDirectoryUrl,
-        compileServerOrigin,
-        fileRelativeUrl,
-        page,
-        jsenvDirectoryRelativeUrl,
-        compileId,
-        collectCoverage,
-        transformErrorHook,
-      })
-    } else {
-      executionResult = await executeSource({
-        projectDirectoryUrl,
-        compileServerOrigin,
-        fileRelativeUrl,
-        page,
-        collectCoverage,
-        coverageIgnorePredicate,
-        transformErrorHook,
-      })
-    }
-
-    if (collectPerformance) {
-      const performance = await page.evaluate(
-        /* istanbul ignore next */
-        () => {
-          // eslint-disable-next-line no-undef
-          const { performance } = window
-          if (!performance) {
-            return null
-          }
-
-          const measures = {}
-          const measurePerfEntries = performance.getEntriesByType("measure")
-          measurePerfEntries.forEach((measurePerfEntry) => {
-            measures[measurePerfEntry.name] = measurePerfEntry.duration
-          })
-
-          return {
-            timeOrigin: performance.timeOrigin,
-            timing: performance.timing.toJSON(),
-            navigation: performance.navigation.toJSON(),
-            measures,
-          }
-        },
-      )
-      executionResult.performance = performance
-    }
-
-    return executionResult
-  } catch (error) {
-    // if browser is closed due to abort
-    // before it is able to finish evaluate we can safely ignore
-    // and rethrow with current abort error
-    if (executeOperation.signal.aborted && isBrowserClosedError(error)) {
-      executeOperation.throwIfAborted()
-    }
-    throw error
-  }
-}
-
-const isBrowserClosedError = (error) => {
-  if (error.message.match(/browserContext.newPage: Browser closed/)) {
-    return true
-  }
-
-  if (error.message.match(/^Protocol error \(.*?\): Target closed/)) {
-    return true
-  }
-
-  return false
-}
-
-const executeSource = async ({
-  projectDirectoryUrl,
-  compileServerOrigin,
-  fileRelativeUrl,
-  page,
-  collectCoverage,
-  coverageIgnorePredicate,
-  transformErrorHook,
-}) => {
-  let transformResult = (result) => result
-
-  if (collectCoverage) {
-    await page.coverage.startJSCoverage({
-      // reportAnonymousScripts: true,
-    })
-    transformResult = composeTransformer(transformResult, async (result) => {
-      const v8CoveragesWithWebUrls = await page.coverage.stopJSCoverage()
-      // we convert urls starting with http:// to file:// because we later
-      // convert the url to filesystem path in istanbulCoverageFromV8Coverage function
-      const v8CoveragesWithFsUrls = v8CoveragesWithWebUrls.map(
-        (v8CoveragesWithWebUrl) => {
-          const relativeUrl = urlToRelativeUrl(
-            v8CoveragesWithWebUrl.url,
-            compileServerOrigin,
-          )
-          const fsUrl = resolveUrl(relativeUrl, projectDirectoryUrl)
-          return {
-            ...v8CoveragesWithWebUrl,
-            url: fsUrl,
-          }
-        },
-      )
-      const coverage = filterV8Coverage(
-        { result: v8CoveragesWithFsUrls },
-        {
-          coverageIgnorePredicate,
-        },
-      )
-      return {
-        ...result,
-        coverage,
-      }
-    })
-  } else {
-    transformResult = composeTransformer(transformResult, (result) => {
-      const { namespace: fileExecutionResultMap } = result
-      Object.keys(fileExecutionResultMap).forEach((fileRelativeUrl) => {
-        delete fileExecutionResultMap[fileRelativeUrl].coverage
-      })
-      return result
-    })
-  }
-
-  const fileClientUrl = resolveUrl(fileRelativeUrl, `${compileServerOrigin}/`)
-  await page.goto(fileClientUrl, { timeout: 0 })
-
-  const executionResult = await page.evaluate(
-    /* istanbul ignore next */
-    () => {
-      // eslint-disable-next-line no-undef
-      return window.__jsenv__.executionResultPromise
-    },
-  )
-
-  const { fileExecutionResultMap } = executionResult
-  const fileErrored = Object.keys(fileExecutionResultMap).find(
-    (fileRelativeUrl) => {
-      const fileExecutionResult = fileExecutionResultMap[fileRelativeUrl]
-      return fileExecutionResult.status === "errored"
-    },
-  )
-
-  if (fileErrored) {
-    const { exceptionSource } = fileExecutionResultMap[fileErrored]
-    const error = evalException(exceptionSource, {
-      projectDirectoryUrl,
-      compileServerOrigin,
-      transformErrorHook,
-    })
-    return transformResult({
-      status: "errored",
-      error,
-      namespace: fileExecutionResultMap,
-    })
-  }
-
-  return transformResult({
-    status: "completed",
-    namespace: fileExecutionResultMap,
-  })
-}
-
-const executeCompiledVersion = async ({
-  projectDirectoryUrl,
-  compileServerOrigin,
-  fileRelativeUrl,
-  page,
-  jsenvDirectoryRelativeUrl,
-  compileId,
-  collectCoverage,
-  transformErrorHook,
-}) => {
-  let transformResult = (result) => result
-  if (collectCoverage) {
-    transformResult = composeTransformer(transformResult, async (result) => {
-      result.coverage = generateCoverageForPage(fileExecutionResultMap)
-      return result
-    })
-  } else {
-    transformResult = composeTransformer(transformResult, (result) => {
-      const { namespace: fileExecutionResultMap } = result
-      Object.keys(fileExecutionResultMap).forEach((fileRelativeUrl) => {
-        delete fileExecutionResultMap[fileRelativeUrl].coverage
-      })
-      return result
-    })
-  }
-
-  const compileDirectoryRelativeUrl = `${jsenvDirectoryRelativeUrl}${compileId}/`
-  const compileDirectoryRemoteUrl = resolveUrl(
-    compileDirectoryRelativeUrl,
-    compileServerOrigin,
-  )
-  const fileClientUrl = resolveUrl(fileRelativeUrl, compileDirectoryRemoteUrl)
-  await page.goto(fileClientUrl, { timeout: 0 })
-
-  const executionResult = await page.evaluate(
-    /* eslint-disable no-undef */
-    /* istanbul ignore next */
-    () => {
-      return window.__jsenv__.executionResultPromise
-    },
-    /* eslint-enable no-undef */
-  )
-
-  const { fileExecutionResultMap } = executionResult
-  const fileErrored = Object.keys(fileExecutionResultMap).find(
-    (fileRelativeUrl) => {
-      const fileExecutionResult = fileExecutionResultMap[fileRelativeUrl]
-      return fileExecutionResult.status === "errored"
-    },
-  )
-
-  if (fileErrored) {
-    const { exceptionSource } = fileExecutionResultMap[fileErrored]
-    const error = evalException(exceptionSource, {
-      projectDirectoryUrl,
-      compileServerOrigin,
-      transformErrorHook,
-    })
-    return transformResult({
-      status: "errored",
-      error,
-      namespace: fileExecutionResultMap,
-    })
-  }
-
-  return transformResult({
-    status: "completed",
-    namespace: fileExecutionResultMap,
-  })
-}
-
-const generateCoverageForPage = (fileExecutionResultMap) => {
-  let istanbulCoverageComposed = null
-  Object.keys(fileExecutionResultMap).forEach((fileRelativeUrl) => {
-    const istanbulCoverage = fileExecutionResultMap[fileRelativeUrl].coverage
-    istanbulCoverageComposed = istanbulCoverageComposed
-      ? composeTwoFileByFileIstanbulCoverages(
-          istanbulCoverageComposed,
-          istanbulCoverage,
-        )
-      : istanbulCoverage
-  })
-
-  return istanbulCoverageComposed
-}
-
-const evalException = (
-  exceptionSource,
-  { projectDirectoryUrl, compileServerOrigin, transformErrorHook },
-) => {
-  let error = evalSource(exceptionSource)
-
-  if (error && error instanceof Error) {
-    const remoteRootRegexp = new RegExp(
-      escapeRegexpSpecialCharacters(`${compileServerOrigin}/`),
-      "g",
-    )
-    error.stack = error.stack.replace(remoteRootRegexp, projectDirectoryUrl)
-    error.message = error.message.replace(remoteRootRegexp, projectDirectoryUrl)
-
-    error = transformErrorHook(error)
-  }
-
-  return error
-}
-
-const composeTransformer = (previousTransformer, transformer) => {
-  return (value) => {
-    const transformedValue = previousTransformer(value)
-    return transformer(transformedValue)
-  }
-}