mirror of
https://github.com/zebrajr/react.git
synced 2025-12-06 12:20:20 +01:00
115cd12d9b
In CI, we run our test suite against multiple build configurations. For example, we run our tests in both dev and prod, and in both the experimental and stable release channels. This is to prevent accidental deviations in behavior between the different builds. If there's an intentional deviation in behavior, the test author must account for them. However, we currently don't run tests against the www builds. That's a problem, because it's common for features to land in www before they land anywhere else, including the experimental release channel. Typically we do this so we can gradually roll out the feature behind a flag before deciding to enable it. The way we test those features today is by mutating the `shared/ReactFeatureFlags` module. There are a few downsides to this approach, though. The flag is only overridden for the specific tests or test suites where you apply the override. But usually what you want is to run *all* tests with the flag enabled, to protect against unexpected regressions. Also, mutating the feature flags module only works when running the tests against source, not against the final build artifacts, because the ReactFeatureFlags module is inlined by the build script. Instead, we should run the test suite against the www configuration, just like we do for prod, experimental, and so on. I've added a new command, `yarn test-www`. It automatically runs in CI. Some of the www feature flags are dynamic; that is, they depend on a runtime condition (i.e. a GK). These flags are imported from an external module that lives in www. Those flags will be enabled for some clients and disabled for others, so we should run the tests against *both* modes. So I've added a new global `__VARIANT__`, and a new test command `yarn test-www-variant`. `__VARIANT__` is set to false by default; when running `test-www-variant`, it's set to true. If we were going for *really* comprehensive coverage, we would run the tests against every possible configuration of feature flags: 2 ^ numberOfFlags total combinations. That's not practical, though, so instead we only run against two combinations: once with `__VARIANT__` set to `true`, and once with it set to `false`. We generally assume that flags can be toggled independently, so in practice this should be enough. You can also refer to `__VARIANT__` in tests to detect which mode you're running in. Or, you can import `shared/ReactFeatureFlags` and read the specific flag you can about. However, we should stop mutating that module going forward. Treat it as read-only. In this commit, I have only setup the www tests to run against source. I'll leave running against build for a follow up. Many of our tests currently assume they run only in the default configuration, and break when certain flags are toggled. Rather than fix these all up front, I've hard-coded the relevant flags to the default values. We can incrementally migrate those tests later.
113 lines
3.5 KiB
JavaScript
113 lines
3.5 KiB
JavaScript
/**
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @flow
|
|
*/
|
|
|
|
import typeof * as FeatureFlagsType from 'shared/ReactFeatureFlags';
|
|
import typeof * as ExportsType from './ReactFeatureFlags.www';
|
|
import typeof * as DynamicFeatureFlags from './ReactFeatureFlags.www-dynamic';
|
|
|
|
// Re-export dynamic flags from the www version.
|
|
const dynamicFeatureFlags: DynamicFeatureFlags = require('ReactFeatureFlags');
|
|
|
|
export const {
|
|
debugRenderPhaseSideEffectsForStrictMode,
|
|
deferPassiveEffectCleanupDuringUnmount,
|
|
disableInputAttributeSyncing,
|
|
enableTrustedTypesIntegration,
|
|
runAllPassiveEffectDestroysBeforeCreates,
|
|
warnAboutShorthandPropertyCollision,
|
|
disableSchedulerTimeoutBasedOnReactExpirationTime,
|
|
warnAboutSpreadingKeyToJSX,
|
|
replayFailedUnitOfWorkWithInvokeGuardedCallback,
|
|
enableModernEventSystem,
|
|
} = dynamicFeatureFlags;
|
|
|
|
// On WWW, __EXPERIMENTAL__ is used for a new modern build.
|
|
// It's not used anywhere in production yet.
|
|
|
|
// In www, we have experimental support for gathering data
|
|
// from User Timing API calls in production. By default, we
|
|
// only emit performance.mark/measure calls in __DEV__. But if
|
|
// somebody calls addUserTimingListener() which is exposed as an
|
|
// experimental FB-only export, we call performance.mark/measure
|
|
// as long as there is more than a single listener.
|
|
export let enableUserTimingAPI = __DEV__ && !__EXPERIMENTAL__;
|
|
|
|
export const enableProfilerTimer = __PROFILE__;
|
|
export const enableProfilerCommitHooks = false;
|
|
export const enableSchedulerTracing = __PROFILE__;
|
|
export const enableSchedulerDebugging = true;
|
|
|
|
export const warnAboutDeprecatedLifecycles = true;
|
|
export const disableLegacyContext = __EXPERIMENTAL__;
|
|
export const warnAboutStringRefs = false;
|
|
export const warnAboutDefaultPropsOnFunctionComponents = false;
|
|
|
|
export const enableSuspenseServerRenderer = true;
|
|
export const enableSelectiveHydration = true;
|
|
|
|
export const enableBlocksAPI = true;
|
|
|
|
export const disableJavaScriptURLs = true;
|
|
|
|
let refCount = 0;
|
|
export function addUserTimingListener() {
|
|
if (__DEV__) {
|
|
// Noop.
|
|
return () => {};
|
|
}
|
|
refCount++;
|
|
updateFlagOutsideOfReactCallStack();
|
|
return () => {
|
|
refCount--;
|
|
updateFlagOutsideOfReactCallStack();
|
|
};
|
|
}
|
|
|
|
// The flag is intentionally updated in a timeout.
|
|
// We don't support toggling it during reconciliation or
|
|
// commit since that would cause mismatching user timing API calls.
|
|
let timeout = null;
|
|
function updateFlagOutsideOfReactCallStack() {
|
|
if (!timeout) {
|
|
timeout = setTimeout(() => {
|
|
timeout = null;
|
|
enableUserTimingAPI = refCount > 0;
|
|
});
|
|
}
|
|
}
|
|
|
|
export const enableDeprecatedFlareAPI = true;
|
|
|
|
export const enableFundamentalAPI = false;
|
|
|
|
export const enableScopeAPI = true;
|
|
|
|
export const warnAboutUnmockedScheduler = true;
|
|
|
|
export const enableSuspenseCallback = true;
|
|
|
|
export const flushSuspenseFallbacksInTests = true;
|
|
|
|
export const disableTextareaChildren = __EXPERIMENTAL__;
|
|
|
|
export const disableMapsAsChildren = __EXPERIMENTAL__;
|
|
|
|
export const warnUnstableRenderSubtreeIntoContainer = false;
|
|
|
|
export const enableLegacyFBPrimerSupport = !__EXPERIMENTAL__;
|
|
|
|
// Internal-only attempt to debug a React Native issue. See D20130868.
|
|
export const throwEarlyForMysteriousError = false;
|
|
|
|
// Flow magic to verify the exports of this file match the original version.
|
|
// eslint-disable-next-line no-unused-vars
|
|
type Check<_X, Y: _X, X: Y = _X> = null;
|
|
// eslint-disable-next-line no-unused-expressions
|
|
(null: Check<ExportsType, FeatureFlagsType>);
|