mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Rubén NorteandFacebook GitHub Bot
65974e938c
Summary: Pull Request resolved: https://github.com/facebook/react-native/pull/53215 Changelog: [internal] This adds a new environment variable to Fantom that allows debugging the JS code in tests. Usage: ``` FANTOM_DEBUG_JS=1 yarn fantom <test> ``` **Does NOT work in OSS yet**. We need to include a third-party library to send HTTP and WebSocket requests and implement a wrapper on top of it. Reviewed By: christophpurrer Differential Revision: D79883372 fbshipit-source-id: d077c373a036033344e61d58274d5cd14028bda4
101 lines
3.1 KiB
JavaScript
101 lines
3.1 KiB
JavaScript
/**
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @flow strict
|
|
* @format
|
|
*/
|
|
|
|
const VALID_ENVIRONMENT_VARIABLES = [
|
|
'FANTOM_DEBUG_CPP',
|
|
'FANTOM_ENABLE_CPP_DEBUGGING',
|
|
'FANTOM_FORCE_CI_MODE',
|
|
'FANTOM_FORCE_OSS_BUILD',
|
|
'FANTOM_FORCE_TEST_MODE',
|
|
'FANTOM_LOG_COMMANDS',
|
|
'FANTOM_PRINT_OUTPUT',
|
|
'FANTOM_DEBUG_JS',
|
|
'FANTOM_PROFILE_JS',
|
|
'FANTOM_ENABLE_JS_MEMORY_INSTRUMENTATION',
|
|
];
|
|
|
|
/**
|
|
* Prints the output of the Fantom tester to the test output.
|
|
*/
|
|
export const printCLIOutput: boolean = Boolean(process.env.FANTOM_PRINT_OUTPUT);
|
|
|
|
/**
|
|
* Logs all external commands executed by the runner.
|
|
*/
|
|
export const logCommands: boolean = Boolean(process.env.FANTOM_LOG_COMMANDS);
|
|
|
|
/**
|
|
* Enables the C++ debugger for the current test run.
|
|
*/
|
|
export const debugCpp: boolean =
|
|
Boolean(process.env.FANTOM_DEBUG_CPP) ||
|
|
// Legacy
|
|
Boolean(process.env.FANTOM_ENABLE_CPP_DEBUGGING);
|
|
|
|
/**
|
|
* Indicates if the current test run is done in an OSS environment (as opposed
|
|
* to internal Meta infra).
|
|
*/
|
|
export const isOSS: boolean = Boolean(process.env.FANTOM_FORCE_OSS_BUILD);
|
|
|
|
/**
|
|
* Indicates if the current test run is done in CI, which forces:
|
|
* 1. Prebuilding all binaries (Fantom tester and Hermes compiler).
|
|
* 2. Running benchmarks in test mode (see below).
|
|
*/
|
|
export const isCI: boolean =
|
|
Boolean(process.env.FANTOM_FORCE_CI_MODE) ||
|
|
Boolean(process.env.SANDCASTLE) ||
|
|
Boolean(process.env.GITHUB_ACTIONS);
|
|
|
|
/**
|
|
* Forces benchmarks to run in test mode (running a single time to ensure
|
|
* correctness instead of multiples times to measure performance).
|
|
*/
|
|
export const forceTestModeForBenchmarks: boolean = Boolean(
|
|
process.env.FANTOM_FORCE_TEST_MODE,
|
|
);
|
|
|
|
export const debugJS: boolean = Boolean(process.env.FANTOM_DEBUG_JS);
|
|
|
|
export const profileJS: boolean = Boolean(process.env.FANTOM_PROFILE_JS);
|
|
|
|
export const enableJSMemoryInstrumentation: boolean = Boolean(
|
|
process.env.FANTOM_ENABLE_JS_MEMORY_INSTRUMENTATION,
|
|
);
|
|
|
|
/**
|
|
* Throws an error if there is an environment variable defined with the FANTOM_
|
|
* prefix that is not recognized.
|
|
*/
|
|
export function validateEnvironmentVariables(): void {
|
|
for (const key of Object.keys(process.env)) {
|
|
if (
|
|
key.startsWith('FANTOM_') &&
|
|
!VALID_ENVIRONMENT_VARIABLES.includes(key)
|
|
) {
|
|
throw new Error(
|
|
`Unexpected Fantom environment variable: ${key}=${String(process.env[key])}. Accepted variables are: ${VALID_ENVIRONMENT_VARIABLES.join(', ')}`,
|
|
);
|
|
}
|
|
}
|
|
|
|
// Enabling memory instrumentation is only necessary when taking JS heap
|
|
// snapshots in optimized builds (where it is disabled by default).
|
|
// This isn't supported in CI or in OSS because that would require adding
|
|
// another dimension to the build matrix, duplicating the number of binaries
|
|
// we need to build before starting test execution.
|
|
if ((isCI || isOSS) && enableJSMemoryInstrumentation) {
|
|
throw new Error(
|
|
'Memory instrumentation is not supported in CI or OSS environments, as it requires a custom Hermes build that is not prebuilt in those environments.',
|
|
);
|
|
}
|
|
}
|