Add support for recursiveDenylist option as an alternative to recursiveBlacklist (#10649)

Author: wojtekmaj

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ### Features
 
+- `[jest-validate]` Add support for `recursiveDenylist` option as an alternative to `recursiveBlacklist` ([#10236](https://github.com/facebook/jest/pull/10236))
+
 ### Fixes
 
 ### Chore & Maintenance

packages/jest-validate/README.md

@@ -62,7 +62,7 @@ Almost anything can be overwritten to suite your needs.
 
 ### Options
 
-- `recursiveBlacklist` – optional array of string keyPaths that should be excluded from deep (recursive) validation.
+- `recursiveDenylist` – optional array of string keyPaths that should be excluded from deep (recursive) validation.
 - `comment` – optional string to be rendered below error/warning message.
 - `condition` – an optional function with validation condition.
 - `deprecate`, `error`, `unknown` – optional functions responsible for displaying warning and error messages.

packages/jest-validate/src/__tests__/validate.test.ts

@@ -101,7 +101,7 @@ test.each([
   },
 );
 
-test('respects blacklist', () => {
+test('respects recursiveBlacklist', () => {
   const warn = console.warn;
   console.warn = jest.fn();
   const config = {
@@ -135,6 +135,40 @@ test('respects blacklist', () => {
   console.warn = warn;
 });
 
+test('respects recursiveDenylist', () => {
+  const warn = console.warn;
+  console.warn = jest.fn();
+  const config = {
+    something: {
+      nested: {
+        some_random_key: 'value',
+        some_random_key2: 'value2',
+      },
+    },
+  };
+  const exampleConfig = {
+    something: {
+      nested: {
+        test: true,
+      },
+    },
+  };
+
+  validate(config, {exampleConfig});
+
+  expect(console.warn).toBeCalled();
+
+  console.warn.mockReset();
+
+  validate(config, {
+    exampleConfig,
+    recursiveDenylist: ['something.nested'],
+  });
+
+  expect(console.warn).not.toBeCalled();
+  console.warn = warn;
+});
+
 test('displays warning for unknown config options', () => {
   const config = {unkwon: {}};
   const validConfig = {unknown: 'string'};
@@ -292,7 +326,7 @@ test('Comments in config JSON using "//" key are not warned', () => {
 
   validate(config, {
     exampleConfig: validConfig,
-    recursiveBlacklist: ['myCustomKey' as "don't validate this"],
+    recursiveDenylist: ['myCustomKey' as "don't validate this"],
   });
   expect(console.warn).not.toBeCalled();
 

packages/jest-validate/src/defaultConfig.ts

@@ -22,7 +22,7 @@ const validationOptions: ValidationOptions = {
   exampleConfig: {},
   recursive: true,
   // Allow NPM-sanctioned comments in package.json. Use a "//" key.
-  recursiveBlacklist: ['//'],
+  recursiveDenylist: ['//'],
   title: {
     deprecation: DEPRECATION,
     error: ERROR,

packages/jest-validate/src/exampleConfig.ts

@@ -17,7 +17,7 @@ const config: ValidationOptions = {
   error: () => {},
   exampleConfig: {key: 'value', test: 'case'},
   recursive: true,
-  recursiveBlacklist: [],
+  recursiveDenylist: [],
   title: {
     deprecation: 'Deprecation Warning',
     error: 'Validation Error',

packages/jest-validate/src/types.ts

@@ -35,6 +35,7 @@ export type ValidationOptions = {
   exampleConfig: Record<string, unknown>;
   recursive?: boolean;
   recursiveBlacklist?: Array<string>;
+  recursiveDenylist?: Array<string>;
   title?: Title;
   unknown?: (
     config: Record<string, unknown>,

packages/jest-validate/src/validate.ts

@@ -14,8 +14,8 @@ let hasDeprecationWarnings = false;
 const shouldSkipValidationForPath = (
   path: Array<string>,
   key: string,
-  blacklist?: Array<string>,
-) => (blacklist ? blacklist.includes([...path, key].join('.')) : false);
+  denylist?: Array<string>,
+) => (denylist ? denylist.includes([...path, key].join('.')) : false);
 
 const _validate = (
   config: Record<string, any>,
@@ -70,7 +70,11 @@ const _validate = (
         options.error(key, config[key], exampleConfig[key], options, path);
       }
     } else if (
-      shouldSkipValidationForPath(path, key, options.recursiveBlacklist)
+      shouldSkipValidationForPath(
+        path,
+        key,
+        options.recursiveDenylist || options.recursiveBlacklist,
+      )
     ) {
       // skip validating unknown options inside blacklisted paths
     } else {
@@ -81,8 +85,12 @@ const _validate = (
     if (
       options.recursive &&
       !Array.isArray(exampleConfig[key]) &&
-      options.recursiveBlacklist &&
-      !shouldSkipValidationForPath(path, key, options.recursiveBlacklist)
+      (options.recursiveDenylist || options.recursiveBlacklist) &&
+      !shouldSkipValidationForPath(
+        path,
+        key,
+        options.recursiveDenylist || options.recursiveBlacklist,
+      )
     ) {
       _validate(config[key], exampleConfig[key], options, [...path, key]);
     }
@@ -101,16 +109,16 @@ const validate = (
 ): {hasDeprecationWarnings: boolean; isValid: boolean} => {
   hasDeprecationWarnings = false;
 
-  // Preserve default blacklist entries even with user-supplied blacklist
-  const combinedBlacklist: Array<string> = [
-    ...(defaultConfig.recursiveBlacklist || []),
-    ...(options.recursiveBlacklist || []),
+  // Preserve default denylist entries even with user-supplied denylist
+  const combinedDenylist: Array<string> = [
+    ...(defaultConfig.recursiveDenylist || []),
+    ...(options.recursiveDenylist || options.recursiveBlacklist || []),
   ];
 
   const defaultedOptions: ValidationOptions = Object.assign({
     ...defaultConfig,
     ...options,
-    recursiveBlacklist: combinedBlacklist,
+    recursiveDenylist: combinedDenylist,
     title: options.title || defaultConfig.title,
   });