Use no-op for production instanceOf

src/__tests__/env-test.ts

@@ -0,0 +1,20 @@
+import { expect } from 'chai';
+import { describe, it } from 'mocha';
+
+import { getEnv, setEnv } from '../setEnv.js';
+
+describe('Env', () => {
+  it('should return undefined if environment is not set', () => {
+    expect(getEnv()).to.equal(undefined);
+  });
+
+  it('should set the environment to development', () => {
+    setEnv('development');
+    expect(getEnv()).to.equal('development');
+  });
+
+  it('should set the environment to production', () => {
+    setEnv('production');
+    expect(getEnv()).to.equal('production');
+  });
+});

src/index.ts

@@ -28,6 +28,8 @@
 
 // The GraphQL.js version info.
 export { version, versionInfo } from './version.js';
+export { setEnv, getEnv } from './setEnv.js';
+export type { Env } from './setEnv.js';
 
 // The primary entry point into fulfilling a GraphQL request.
 export type { GraphQLArgs } from './graphql.js';

src/jsutils/__tests__/instanceOf-test.ts

@@ -1,9 +1,25 @@
 import { expect } from 'chai';
 import { describe, it } from 'mocha';
 
+import { setEnv } from '../../setEnv.js';
+
 import { instanceOf } from '../instanceOf.js';
 
 describe('instanceOf', () => {
+  function oldVersion() {
+    class Foo {}
+    return Foo;
+  }
+
+  function newVersion() {
+    class Foo {
+      get [Symbol.toStringTag]() {
+        return 'Foo';
+      }
+    }
+    return Foo;
+  }
+
   it('do not throw on values without prototype', () => {
     class Foo {
       get [Symbol.toStringTag]() {
@@ -16,28 +32,39 @@ describe('instanceOf', () => {
     expect(instanceOf(Object.create(null), Foo)).to.equal(false);
   });
 
-  it('detect name clashes with older versions of this lib', () => {
-    function oldVersion() {
-      class Foo {}
-      return Foo;
-    }
+  it('ignore name clashes with older versions of this lib by default', () => {
+    const NewClass = newVersion();
+    const OldClass = oldVersion();
+    expect(instanceOf(new NewClass(), NewClass)).to.equal(true);
+    expect(instanceOf(new OldClass(), NewClass)).to.equal(false);
+  });
 
-    function newVersion() {
-      class Foo {
-        get [Symbol.toStringTag]() {
-          return 'Foo';
-        }
-      }
-      return Foo;
-    }
+  it('detect name clashes with older versions of this lib when set', () => {
+    setEnv('development');
+
+    const NewClass = newVersion();
+    const OldClass = oldVersion();
+    expect(instanceOf(new NewClass(), NewClass)).to.equal(true);
+    expect(() => instanceOf(new OldClass(), NewClass)).to.throw();
+  });
+
+  it('ignore name clashes with older versions of this lib when reset', () => {
+    setEnv('development');
 
     const NewClass = newVersion();
     const OldClass = oldVersion();
     expect(instanceOf(new NewClass(), NewClass)).to.equal(true);
     expect(() => instanceOf(new OldClass(), NewClass)).to.throw();
+
+    setEnv('production');
+
+    expect(instanceOf(new NewClass(), NewClass)).to.equal(true);
+    expect(instanceOf(new OldClass(), NewClass)).to.equal(false);
   });
 
   it('allows instances to have share the same constructor name', () => {
+    setEnv('development');
+
     function getMinifiedClass(tag: string) {
       class SomeNameAfterMinification {
         get [Symbol.toStringTag]() {
@@ -58,6 +85,8 @@ describe('instanceOf', () => {
   });
 
   it('fails with descriptive error message', () => {
+    setEnv('development');
+
     function getFoo() {
       class Foo {
         get [Symbol.toStringTag]() {

src/jsutils/instanceOf.ts

@@ -1,40 +1,43 @@
+import type { Env } from '../setEnv.js';
+
 import { inspect } from './inspect.js';
 
-/* c8 ignore next 3 */
-const isProduction =
-  globalThis.process != null &&
-  // eslint-disable-next-line no-undef
-  process.env.NODE_ENV === 'production';
+const noOp = (_value: unknown, _constructor: Constructor): void => {
+  /* no-op */
+};
+
+let check = noOp;
 
 /**
  * A replacement for instanceof which includes an error warning when multi-realm
  * constructors are detected.
  * See: https://expressjs.com/en/advanced/best-practice-performance.html#set-node_env-to-production
  * See: https://webpack.js.org/guides/production/
  */
-export const instanceOf: (value: unknown, constructor: Constructor) => boolean =
-  /* c8 ignore next 6 */
-  // FIXME: https://github.com/graphql/graphql-js/issues/2317
-  isProduction
-    ? function instanceOf(value: unknown, constructor: Constructor): boolean {
-        return value instanceof constructor;
-      }
-    : function instanceOf(value: unknown, constructor: Constructor): boolean {
-        if (value instanceof constructor) {
-          return true;
-        }
-        if (typeof value === 'object' && value !== null) {
-          // Prefer Symbol.toStringTag since it is immune to minification.
-          const className = constructor.prototype[Symbol.toStringTag];
-          const valueClassName =
-            // We still need to support constructor's name to detect conflicts with older versions of this library.
-            Symbol.toStringTag in value
-              ? value[Symbol.toStringTag]
-              : value.constructor?.name;
-          if (className === valueClassName) {
-            const stringifiedValue = inspect(value);
-            throw new Error(
-              `Cannot use ${className} "${stringifiedValue}" from another module or realm.
+export function instanceOf(value: unknown, constructor: Constructor): boolean {
+  if (value instanceof constructor) {
+    return true;
+  }
+  check(value, constructor);
+  return false;
+}
+
+function developmentInstanceOfCheck(
+  value: unknown,
+  constructor: Constructor,
+): void {
+  if (typeof value === 'object' && value !== null) {
+    // Prefer Symbol.toStringTag since it is immune to minification.
+    const className = constructor.prototype[Symbol.toStringTag];
+    const valueClassName =
+      // We still need to support constructor's name to detect conflicts with older versions of this library.
+      Symbol.toStringTag in value
+        ? value[Symbol.toStringTag]
+        : value.constructor?.name;
+    if (className === valueClassName) {
+      const stringifiedValue = inspect(value);
+      throw new Error(
+        `Cannot use ${className} "${stringifiedValue}" from another module or realm.
 
 Ensure that there is only one instance of "graphql" in the node_modules
 directory. If different versions of "graphql" are the dependencies of other
@@ -46,11 +49,14 @@ Duplicate "graphql" modules cannot be used at the same time since different
 versions may have different capabilities and behavior. The data from one
 version used in the function from another could produce confusing and
 spurious results.`,
-            );
-          }
-        }
-        return false;
-      };
+      );
+    }
+  }
+}
+
+export function setInstanceOfCheckForEnv(newEnv: Env): void {
+  check = newEnv === 'development' ? developmentInstanceOfCheck : noOp;
+}
 
 interface Constructor {
   prototype: {

src/setEnv.ts

@@ -0,0 +1,14 @@
+import { setInstanceOfCheckForEnv } from './jsutils/instanceOf.js';
+
+export type Env = 'production' | 'development';
+
+let env: Env | undefined;
+
+export function setEnv(newEnv: Env): void {
+  env = newEnv;
+  setInstanceOfCheckForEnv(newEnv);
+}
+
+export function getEnv(): Env | undefined {
+  return env;
+}