Support RegExp in ignoredPaths/ignoredActionPaths

Fix: #2553

Author: indutny

docs/api/serializabilityMiddleware.mdx

@@ -39,16 +39,17 @@ interface SerializableStateInvariantMiddlewareOptions {
   ignoredActions?: string[]
 
   /**
-   * An array of dot-separated path strings to ignore when checking
-   * for serializability, Defaults to ['meta.arg', 'meta.baseQueryMeta']
+   * An array of dot-separated path strings or regular expressions to ignore
+   * when checking for serializability, Defaults to
+   * ['meta.arg', 'meta.baseQueryMeta']
    */
-  ignoredActionPaths?: string[]
+  ignoredActionPaths?: (string | RegExp)[]
 
   /**
-   * An array of dot-separated path strings to ignore when checking
-   * for serializability, Defaults to []
+   * An array of dot-separated path strings or regular expressions to ignore
+   * when checking for serializability, Defaults to []
    */
-  ignoredPaths?: string[]
+  ignoredPaths?: (string | RegExp)[]
   /**
    * Execution time warning threshold. If the middleware takes longer
    * than `warnAfter` ms, a warning will be displayed in the console.

packages/rtk-codemods/bin/cli.js

@@ -511,7 +511,7 @@ export function findNonSerializableValue(
   path?: string,
   isSerializable?: (value: unknown) => boolean,
   getEntries?: (value: unknown) => [string, any][],
-  ignoredPaths?: readonly string[]
+  ignoredPaths?: readonly (string | RegExp)[]
 ): NonSerializableValue | false
 
 export { freeze }
@@ -762,9 +762,9 @@ export { Selector }
 // @public
 export interface SerializableStateInvariantMiddlewareOptions {
   getEntries?: (value: any) => [string, any][]
-  ignoredActionPaths?: string[]
+  ignoredActionPaths?: (string | RegExp)[]
   ignoredActions?: string[]
-  ignoredPaths?: string[]
+  ignoredPaths?: (string | RegExp)[]
   ignoreState?: boolean
   isSerializable?: (value: any) => boolean
   warnAfter?: number

packages/toolkit/etc/redux-toolkit.api.md

@@ -36,7 +36,7 @@ export function findNonSerializableValue(
   path: string = '',
   isSerializable: (value: unknown) => boolean = isPlain,
   getEntries?: (value: unknown) => [string, any][],
-  ignoredPaths: readonly string[] = []
+  ignoredPaths: readonly (string | RegExp)[] = []
 ): NonSerializableValue | false {
   let foundNestedSerializable: NonSerializableValue | false
 
@@ -58,8 +58,16 @@ export function findNonSerializableValue(
   for (const [key, nestedValue] of entries) {
     const nestedPath = path ? path + '.' + key : key
 
-    if (hasIgnoredPaths && ignoredPaths.indexOf(nestedPath) >= 0) {
-      continue
+    if (hasIgnoredPaths) {
+      const hasMatches = ignoredPaths.some(ignored => {
+        if (ignored instanceof RegExp) {
+          return ignored.test(nestedPath)
+        }
+        return nestedPath === ignored
+      })
+      if (hasMatches) {
+        continue
+      }
     }
 
     if (!isSerializable(nestedValue)) {
@@ -113,16 +121,17 @@ export interface SerializableStateInvariantMiddlewareOptions {
   ignoredActions?: string[]
 
   /**
-   * An array of dot-separated path strings to ignore when checking
-   * for serializability, Defaults to ['meta.arg', 'meta.baseQueryMeta']
+   * An array of dot-separated path strings or regular expressions to ignore
+   * when checking for serializability, Defaults to
+   * ['meta.arg', 'meta.baseQueryMeta']
    */
-  ignoredActionPaths?: string[]
+  ignoredActionPaths?: (string | RegExp)[]
 
   /**
-   * An array of dot-separated path strings to ignore when checking
-   * for serializability, Defaults to []
+   * An array of dot-separated path strings or regular expressions to ignore
+   * when checking for serializability, Defaults to []
    */
-  ignoredPaths?: string[]
+  ignoredPaths?: (string | RegExp)[]
   /**
    * Execution time warning threshold. If the middleware takes longer
    * than `warnAfter` ms, a warning will be displayed in the console.

packages/toolkit/src/serializableStateInvariantMiddleware.ts

@@ -31,6 +31,8 @@ Take a look at the reducer(s) handling this action type: TEST_ACTION.
 
 exports[`serializableStateInvariantMiddleware ignored action paths can specify (multiple) different values 1`] = `""`;
 
+exports[`serializableStateInvariantMiddleware ignored action paths can specify regexp 1`] = `""`;
+
 exports[`serializableStateInvariantMiddleware ignored action paths default value can be overridden 1`] = `
 "A non-serializable value was detected in an action, in the path: \`meta.arg\`. Value: Map {} 
 Take a look at the logic that dispatched this action:  Object {

packages/toolkit/src/tests/__snapshots__/serializableStateInvariantMiddleware.test.ts.snap

@@ -389,6 +389,22 @@ describe('serializableStateInvariantMiddleware', () => {
 
       expect(getLog().log).toMatchInlineSnapshot(`""`)
     })
+
+    it('can specify regexp', () => {
+      configureStore({
+        reducer,
+        middleware: [
+          createSerializableStateInvariantMiddleware({
+            ignoredActionPaths: [/^payload\..*$/],
+          }),
+        ],
+      }).dispatch({
+        type: 'test',
+        payload: { arg: nonSerializableValue },
+      })
+
+      expect(getLog().log).toMatchInlineSnapshot(`""`)
+    })
   })
 
   it('allows ignoring actions entirely', () => {
@@ -439,6 +455,10 @@ describe('serializableStateInvariantMiddleware', () => {
               d: badValue,
             },
             e: { f: badValue },
+            g: {
+              h: badValue,
+              i: badValue,
+            },
           }
         }
         default:
@@ -455,6 +475,8 @@ describe('serializableStateInvariantMiddleware', () => {
           'testSlice.b.c',
           // Test for ignoring an object and its children
           'testSlice.e',
+          // Test for ignoring based on RegExp
+          /^testSlice\.g\..*$/,
         ],
       })