graphql 14.0.0 → 14.1.1

package/README.md

@@ -2,14 +2,14 @@
 
 The JavaScript reference implementation for GraphQL, a query language for APIs created by Facebook.
 
-[![npm version](https://badge.fury.io/js/graphql.svg)](http://badge.fury.io/js/graphql)
+[![npm version](https://badge.fury.io/js/graphql.svg)](https://badge.fury.io/js/graphql)
 [![Build Status](https://travis-ci.org/graphql/graphql-js.svg?branch=master)](https://travis-ci.org/graphql/graphql-js?branch=master)
 [![Coverage Status](https://coveralls.io/repos/graphql/graphql-js/badge.svg?branch=master)](https://coveralls.io/r/graphql/graphql-js?branch=master)
 
-See more complete documentation at http://graphql.org/ and
-http://graphql.org/graphql-js/.
+See more complete documentation at https://graphql.org/ and
+https://graphql.org/graphql-js/.
 
-Looking for help? Find resources [from the community](http://graphql.org/community/).
+Looking for help? Find resources [from the community](https://graphql.org/community/).
 
 
 ## Getting Started

package/error/GraphQLError.js

@@ -15,7 +15,7 @@ var _location = require("../language/location");
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 function GraphQLError( // eslint-disable-line no-redeclare
 message, nodes, source, positions, path, originalError, extensions) {

package/error/GraphQLError.js.flow

@@ -22,7 +22,7 @@ import type { Source } from '../language/source';
 declare class GraphQLError extends Error {
   constructor(
     message: string,
-    nodes?: $ReadOnlyArray<ASTNode> | ASTNode | void,
+    nodes?: $ReadOnlyArray<ASTNode> | ASTNode | void | null,
     source?: ?Source,
     positions?: ?$ReadOnlyArray<number>,
     path?: ?$ReadOnlyArray<string | number>,
@@ -104,8 +104,8 @@ export function GraphQLError( // eslint-disable-line no-redeclare
       ? nodes
       : undefined
     : nodes
-      ? [nodes]
-      : undefined;
+    ? [nodes]
+    : undefined;
 
   // Compute locations in the source for the given nodes/positions.
   let _source = source;

package/error/GraphQLError.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 import { printError } from './printError';
 import { getLocation } from '../language/location';

package/error/formatError.js

@@ -15,7 +15,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**

package/error/formatError.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 import invariant from '../jsutils/invariant';
 

package/error/index.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 export { GraphQLError } from './GraphQLError';
 export { syntaxError } from './syntaxError';

package/error/locatedError.js

@@ -13,7 +13,7 @@ var _GraphQLError = require("./GraphQLError");
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**

package/error/locatedError.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 import { GraphQLError } from './GraphQLError';
 

package/error/printError.js

@@ -13,7 +13,7 @@ var _location = require("../language/location");
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**

package/error/printError.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 import { getLocation } from '../language/location';
 

package/error/syntaxError.js

@@ -13,7 +13,7 @@ var _GraphQLError = require("./GraphQLError");
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**

package/error/syntaxError.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 import { GraphQLError } from './GraphQLError';
 /**

package/execution/execute.js

@@ -187,7 +187,7 @@ function buildExecutionContext(schema, document, rootValue, contextValue, rawVar
       errors.push(new _GraphQLError.GraphQLError('Must provide an operation.'));
     }
   } else if (hasMultipleAssumedOperations) {
-    errors.push(new _GraphQLError.GraphQLError('Must provide operation name if query contains ' + 'multiple operations.'));
+    errors.push(new _GraphQLError.GraphQLError('Must provide operation name if query contains multiple operations.'));
   }
 
   var variableValues;
@@ -371,7 +371,7 @@ function collectFields(exeContext, runtimeType, selectionSet, fields, visitedFra
 }
 /**
  * Determines if a field should be included based on the @include and @skip
- * directives, where @skip has higher precidence than @include.
+ * directives, where @skip has higher precedence than @include.
  */
 
 
@@ -668,7 +668,7 @@ function ensureValidRuntimeType(runtimeTypeOrName, exeContext, returnType, field
   var runtimeType = typeof runtimeTypeOrName === 'string' ? exeContext.schema.getType(runtimeTypeOrName) : runtimeTypeOrName;
 
   if (!(0, _definition.isObjectType)(runtimeType)) {
-    throw new _GraphQLError.GraphQLError("Abstract type ".concat(returnType.name, " must resolve to an Object type at ") + "runtime for field ".concat(info.parentType.name, ".").concat(info.fieldName, " with ") + "value ".concat((0, _inspect.default)(result), ", received \"").concat((0, _inspect.default)(runtimeType), "\". ") + "Either the ".concat(returnType.name, " type should provide a \"resolveType\" ") + 'function or each possible type should provide an ' + '"isTypeOf" function.', fieldNodes);
+    throw new _GraphQLError.GraphQLError("Abstract type ".concat(returnType.name, " must resolve to an Object type at ") + "runtime for field ".concat(info.parentType.name, ".").concat(info.fieldName, " with ") + "value ".concat((0, _inspect.default)(result), ", received \"").concat((0, _inspect.default)(runtimeType), "\". ") + "Either the ".concat(returnType.name, " type should provide a \"resolveType\" ") + 'function or each possible type should provide an "isTypeOf" function.', fieldNodes);
   }
 
   if (!exeContext.schema.isPossibleType(returnType, runtimeType)) {
@@ -806,7 +806,7 @@ var defaultFieldResolver = function defaultFieldResolver(source, args, contextVa
   }
 };
 /**
- * This method looks up the field on the given type defintion.
+ * This method looks up the field on the given type definition.
  * It has special casing for the two introspection fields, __schema
  * and __typename. __typename is special because it can always be
  * queried as a field, even in situations where no other fields

package/execution/execute.js.flow

@@ -336,8 +336,7 @@ export function buildExecutionContext(
   } else if (hasMultipleAssumedOperations) {
     errors.push(
       new GraphQLError(
-        'Must provide operation name if query contains ' +
-          'multiple operations.',
+        'Must provide operation name if query contains multiple operations.',
       ),
     );
   }
@@ -576,7 +575,7 @@ export function collectFields(
 
 /**
  * Determines if a field should be included based on the @include and @skip
- * directives, where @skip has higher precidence than @include.
+ * directives, where @skip has higher precedence than @include.
  */
 function shouldIncludeNode(
   exeContext: ExecutionContext,
@@ -1049,8 +1048,7 @@ function ensureValidRuntimeType(
         `runtime for field ${info.parentType.name}.${info.fieldName} with ` +
         `value ${inspect(result)}, received "${inspect(runtimeType)}". ` +
         `Either the ${returnType.name} type should provide a "resolveType" ` +
-        'function or each possible type should provide an ' +
-        '"isTypeOf" function.',
+        'function or each possible type should provide an "isTypeOf" function.',
       fieldNodes,
     );
   }
@@ -1240,7 +1238,7 @@ export const defaultFieldResolver: GraphQLFieldResolver<any, *> = function(
 };
 
 /**
- * This method looks up the field on the given type defintion.
+ * This method looks up the field on the given type definition.
  * It has special casing for the two introspection fields, __schema
  * and __typename. __typename is special because it can always be
  * queried as a field, even in situations where no other fields

package/execution/execute.mjs

@@ -6,7 +6,7 @@ function _typeof(obj) { if (typeof Symbol === "function" && typeof Symbol.iterat
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 import { forEach, isCollection } from 'iterall';
 import { GraphQLError } from '../error/GraphQLError';
@@ -155,7 +155,7 @@ export function buildExecutionContext(schema, document, rootValue, contextValue,
       errors.push(new GraphQLError('Must provide an operation.'));
     }
   } else if (hasMultipleAssumedOperations) {
-    errors.push(new GraphQLError('Must provide operation name if query contains ' + 'multiple operations.'));
+    errors.push(new GraphQLError('Must provide operation name if query contains multiple operations.'));
   }
 
   var variableValues;
@@ -338,7 +338,7 @@ export function collectFields(exeContext, runtimeType, selectionSet, fields, vis
 }
 /**
  * Determines if a field should be included based on the @include and @skip
- * directives, where @skip has higher precidence than @include.
+ * directives, where @skip has higher precedence than @include.
  */
 
 function shouldIncludeNode(exeContext, node) {
@@ -632,7 +632,7 @@ function ensureValidRuntimeType(runtimeTypeOrName, exeContext, returnType, field
   var runtimeType = typeof runtimeTypeOrName === 'string' ? exeContext.schema.getType(runtimeTypeOrName) : runtimeTypeOrName;
 
   if (!isObjectType(runtimeType)) {
-    throw new GraphQLError("Abstract type ".concat(returnType.name, " must resolve to an Object type at ") + "runtime for field ".concat(info.parentType.name, ".").concat(info.fieldName, " with ") + "value ".concat(inspect(result), ", received \"").concat(inspect(runtimeType), "\". ") + "Either the ".concat(returnType.name, " type should provide a \"resolveType\" ") + 'function or each possible type should provide an ' + '"isTypeOf" function.', fieldNodes);
+    throw new GraphQLError("Abstract type ".concat(returnType.name, " must resolve to an Object type at ") + "runtime for field ".concat(info.parentType.name, ".").concat(info.fieldName, " with ") + "value ".concat(inspect(result), ", received \"").concat(inspect(runtimeType), "\". ") + "Either the ".concat(returnType.name, " type should provide a \"resolveType\" ") + 'function or each possible type should provide an "isTypeOf" function.', fieldNodes);
   }
 
   if (!exeContext.schema.isPossibleType(returnType, runtimeType)) {
@@ -770,7 +770,7 @@ export var defaultFieldResolver = function defaultFieldResolver(source, args, co
   }
 };
 /**
- * This method looks up the field on the given type defintion.
+ * This method looks up the field on the given type definition.
  * It has special casing for the two introspection fields, __schema
  * and __typename. __typename is special because it can always be
  * queried as a field, even in situations where no other fields

package/execution/index.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 export { execute, defaultFieldResolver, responsePathAsArray } from './execute';
 export { getDirectiveValues } from './values';

package/execution/values.js

@@ -7,9 +7,9 @@ exports.getVariableValues = getVariableValues;
 exports.getArgumentValues = getArgumentValues;
 exports.getDirectiveValues = getDirectiveValues;
 
-var _GraphQLError = require("../error/GraphQLError");
+var _find = _interopRequireDefault(require("../polyfills/find"));
 
-var _find = _interopRequireDefault(require("../jsutils/find"));
+var _GraphQLError = require("../error/GraphQLError");
 
 var _inspect = _interopRequireDefault(require("../jsutils/inspect"));
 
@@ -37,7 +37,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**
@@ -93,7 +93,7 @@ function getVariableValues(schema, varDefNodes, inputs) {
             try {
               for (var _iterator = coercionErrors[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
                 var error = _step.value;
-                error.message = "Variable \"$".concat(varName, "\" got invalid ") + "value ".concat((0, _inspect.default)(value), "; ").concat(error.message);
+                error.message = "Variable \"$".concat(varName, "\" got invalid value ").concat((0, _inspect.default)(value), "; ") + error.message;
               }
             } catch (err) {
               _didIteratorError = true;

package/execution/values.js.flow

@@ -7,8 +7,8 @@
  * @flow strict
  */
 
+import find from '../polyfills/find';
 import { GraphQLError } from '../error/GraphQLError';
-import find from '../jsutils/find';
 import inspect from '../jsutils/inspect';
 import invariant from '../jsutils/invariant';
 import keyMap from '../jsutils/keyMap';
@@ -98,8 +98,8 @@ export function getVariableValues(
           if (coercionErrors) {
             for (const error of coercionErrors) {
               error.message =
-                `Variable "$${varName}" got invalid ` +
-                `value ${inspect(value)}; ${error.message}`;
+                `Variable "$${varName}" got invalid value ${inspect(value)}; ` +
+                error.message;
             }
             errors.push(...coercionErrors);
           } else {

package/execution/values.mjs

@@ -4,10 +4,10 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
+import find from '../polyfills/find';
 import { GraphQLError } from '../error/GraphQLError';
-import find from '../jsutils/find';
 import inspect from '../jsutils/inspect';
 import invariant from '../jsutils/invariant';
 import keyMap from '../jsutils/keyMap';
@@ -71,7 +71,7 @@ export function getVariableValues(schema, varDefNodes, inputs) {
             try {
               for (var _iterator = coercionErrors[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
                 var error = _step.value;
-                error.message = "Variable \"$".concat(varName, "\" got invalid ") + "value ".concat(inspect(value), "; ").concat(error.message);
+                error.message = "Variable \"$".concat(varName, "\" got invalid value ").concat(inspect(value), "; ") + error.message;
               }
             } catch (err) {
               _didIteratorError = true;

package/graphql.js

@@ -20,7 +20,7 @@ var _execute = require("./execution/execute");
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 function graphql(argsOrSchema, source, rootValue, contextValue, variableValues, operationName, fieldResolver) {
   var _arguments = arguments;

package/graphql.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 import { validateSchema } from './type/validate';
 import { parse } from './language/parser';

package/index.js

@@ -363,6 +363,18 @@ Object.defineProperty(exports, "isSpecifiedDirective", {
     return _type.isSpecifiedDirective;
   }
 });
+Object.defineProperty(exports, "assertSchema", {
+  enumerable: true,
+  get: function get() {
+    return _type.assertSchema;
+  }
+});
+Object.defineProperty(exports, "assertDirective", {
+  enumerable: true,
+  get: function get() {
+    return _type.assertDirective;
+  }
+});
 Object.defineProperty(exports, "assertType", {
   enumerable: true,
   get: function get() {

package/index.js.flow

@@ -104,6 +104,8 @@ export {
   isIntrospectionType,
   isSpecifiedDirective,
   // Assertions
+  assertSchema,
+  assertDirective,
   assertType,
   assertScalarType,
   assertObjectType,
@@ -321,6 +323,8 @@ export {
   VariablesInAllowedPositionRule,
 } from './validation';
 
+export type { ValidationRule } from './validation';
+
 // Create, format, and print GraphQL errors.
 export { GraphQLError, formatError, printError } from './error';
 

package/index.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**
@@ -42,7 +42,7 @@ DEFAULT_DEPRECATION_REASON, // Meta-field definitions.
 SchemaMetaFieldDef, TypeMetaFieldDef, TypeNameMetaFieldDef, // GraphQL Types for introspection.
 introspectionTypes, __Schema, __Directive, __DirectiveLocation, __Type, __Field, __InputValue, __EnumValue, __TypeKind, // Predicates
 isSchema, isDirective, isType, isScalarType, isObjectType, isInterfaceType, isUnionType, isEnumType, isInputObjectType, isListType, isNonNullType, isInputType, isOutputType, isLeafType, isCompositeType, isAbstractType, isWrappingType, isNullableType, isNamedType, isRequiredArgument, isRequiredInputField, isSpecifiedScalarType, isIntrospectionType, isSpecifiedDirective, // Assertions
-assertType, assertScalarType, assertObjectType, assertInterfaceType, assertUnionType, assertEnumType, assertInputObjectType, assertListType, assertNonNullType, assertInputType, assertOutputType, assertLeafType, assertCompositeType, assertAbstractType, assertWrappingType, assertNullableType, assertNamedType, // Un-modifiers
+assertSchema, assertDirective, assertType, assertScalarType, assertObjectType, assertInterfaceType, assertUnionType, assertEnumType, assertInputObjectType, assertListType, assertNonNullType, assertInputType, assertOutputType, assertLeafType, assertCompositeType, assertAbstractType, assertWrappingType, assertNullableType, assertNamedType, // Un-modifiers
 getNullableType, getNamedType, // Validate GraphQL schema.
 validateSchema, assertValidSchema } from './type';
 // Parse and operate on GraphQL language source files.
@@ -57,8 +57,8 @@ export { subscribe, createSourceEventStream } from './subscription'; // Validate
 
 export { validate, ValidationContext, // All validation rules in the GraphQL Specification.
 specifiedRules, // Individual validation rules.
-FieldsOnCorrectTypeRule, FragmentsOnCompositeTypesRule, KnownArgumentNamesRule, KnownDirectivesRule, KnownFragmentNamesRule, KnownTypeNamesRule, LoneAnonymousOperationRule, NoFragmentCyclesRule, NoUndefinedVariablesRule, NoUnusedFragmentsRule, NoUnusedVariablesRule, OverlappingFieldsCanBeMergedRule, PossibleFragmentSpreadsRule, ProvidedRequiredArgumentsRule, ScalarLeafsRule, SingleFieldSubscriptionsRule, UniqueArgumentNamesRule, UniqueDirectivesPerLocationRule, UniqueFragmentNamesRule, UniqueInputFieldNamesRule, UniqueOperationNamesRule, UniqueVariableNamesRule, ValuesOfCorrectTypeRule, VariablesAreInputTypesRule, VariablesInAllowedPositionRule } from './validation'; // Create, format, and print GraphQL errors.
-
+FieldsOnCorrectTypeRule, FragmentsOnCompositeTypesRule, KnownArgumentNamesRule, KnownDirectivesRule, KnownFragmentNamesRule, KnownTypeNamesRule, LoneAnonymousOperationRule, NoFragmentCyclesRule, NoUndefinedVariablesRule, NoUnusedFragmentsRule, NoUnusedVariablesRule, OverlappingFieldsCanBeMergedRule, PossibleFragmentSpreadsRule, ProvidedRequiredArgumentsRule, ScalarLeafsRule, SingleFieldSubscriptionsRule, UniqueArgumentNamesRule, UniqueDirectivesPerLocationRule, UniqueFragmentNamesRule, UniqueInputFieldNamesRule, UniqueOperationNamesRule, UniqueVariableNamesRule, ValuesOfCorrectTypeRule, VariablesAreInputTypesRule, VariablesInAllowedPositionRule } from './validation';
+// Create, format, and print GraphQL errors.
 export { GraphQLError, formatError, printError } from './error';
 // Utilities for operating on GraphQL type schema and parsed sources.
 export { // Produce the GraphQL query recommended for a full schema introspection.

package/jsutils/dedent.js

@@ -15,7 +15,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**
@@ -40,7 +40,7 @@ function fixIndent(str) {
  *   {
  *     test
  *   }
- * `
+ * `;
  * str === "{\n  test\n}\n";
  */
 

package/jsutils/dedent.js.flow

@@ -31,7 +31,7 @@ function fixIndent(str: string): string {
  *   {
  *     test
  *   }
- * `
+ * `;
  * str === "{\n  test\n}\n";
  */
 export default function dedent(

package/jsutils/dedent.mjs

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 import invariant from './invariant';
 /**
@@ -30,7 +30,7 @@ function fixIndent(str) {
  *   {
  *     test
  *   }
- * `
+ * `;
  * str === "{\n  test\n}\n";
  */
 

package/jsutils/defineToJSON.js

@@ -3,7 +3,11 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = applyToJSON;
+exports.default = defineToJSON;
+
+var _nodejsCustomInspectSymbol = _interopRequireDefault(require("./nodejsCustomInspectSymbol"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 /**
  * Copyright (c) 2015-present, Facebook, Inc.
@@ -11,13 +15,20 @@ exports.default = applyToJSON;
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**
- * The `applyToJSON()` function defines toJSON() and inspect() prototype
- * methods which are aliases for toString().
+ * The `defineToJSON()` function defines toJSON() and inspect() prototype
+ * methods, if no function provided they become aliases for toString().
  */
-function applyToJSON(classObject) {
-  classObject.prototype.toJSON = classObject.prototype.inspect = classObject.prototype.toString;
+function defineToJSON( // eslint-disable-next-line flowtype/no-weak-types
+classObject) {
+  var fn = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : classObject.prototype.toString;
+  classObject.prototype.toJSON = fn;
+  classObject.prototype.inspect = fn;
+
+  if (_nodejsCustomInspectSymbol.default) {
+    classObject.prototype[_nodejsCustomInspectSymbol.default] = fn;
+  }
 }

package/jsutils/defineToJSON.js.flow

@@ -7,11 +7,20 @@
  * @flow strict
  */
 
+import nodejsCustomInspectSymbol from './nodejsCustomInspectSymbol';
+
 /**
- * The `applyToJSON()` function defines toJSON() and inspect() prototype
- * methods which are aliases for toString().
+ * The `defineToJSON()` function defines toJSON() and inspect() prototype
+ * methods, if no function provided they become aliases for toString().
  */
-export default function applyToJSON(classObject: Class<any>): void {
-  classObject.prototype.toJSON = classObject.prototype.inspect =
-    classObject.prototype.toString;
+export default function defineToJSON(
+  // eslint-disable-next-line flowtype/no-weak-types
+  classObject: Class<any> | Function,
+  fn?: () => any = classObject.prototype.toString,
+): void {
+  classObject.prototype.toJSON = fn;
+  classObject.prototype.inspect = fn;
+  if (nodejsCustomInspectSymbol) {
+    classObject.prototype[nodejsCustomInspectSymbol] = fn;
+  }
 }

package/jsutils/defineToJSON.mjs

@@ -4,13 +4,21 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
-
+import nodejsCustomInspectSymbol from './nodejsCustomInspectSymbol';
 /**
- * The `applyToJSON()` function defines toJSON() and inspect() prototype
- * methods which are aliases for toString().
+ * The `defineToJSON()` function defines toJSON() and inspect() prototype
+ * methods, if no function provided they become aliases for toString().
  */
-export default function applyToJSON(classObject) {
-  classObject.prototype.toJSON = classObject.prototype.inspect = classObject.prototype.toString;
+
+export default function defineToJSON( // eslint-disable-next-line flowtype/no-weak-types
+classObject) {
+  var fn = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : classObject.prototype.toString;
+  classObject.prototype.toJSON = fn;
+  classObject.prototype.inspect = fn;
+
+  if (nodejsCustomInspectSymbol) {
+    classObject.prototype[nodejsCustomInspectSymbol] = fn;
+  }
 }

package/jsutils/defineToStringTag.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = applyToStringTag;
+exports.default = defineToStringTag;
 
 /**
  * Copyright (c) 2015-present, Facebook, Inc.
@@ -11,23 +11,23 @@ exports.default = applyToStringTag;
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- *  strict
+ * 
  */
 
 /**
- * The `applyToStringTag()` function checks first to see if the runtime
+ * The `defineToStringTag()` function checks first to see if the runtime
  * supports the `Symbol` class and then if the `Symbol.toStringTag` constant
  * is defined as a `Symbol` instance. If both conditions are met, the
  * Symbol.toStringTag property is defined as a getter that returns the
  * supplied class constructor's name.
  *
- * @method applyToStringTag
+ * @method defineToStringTag
  *
  * @param {Class<any>} classObject a class such as Object, String, Number but
  * typically one of your own creation through the class keyword; `class A {}`,
  * for example.
  */
-function applyToStringTag(classObject) {
+function defineToStringTag(classObject) {
   if (typeof Symbol === 'function' && Symbol.toStringTag) {
     Object.defineProperty(classObject.prototype, Symbol.toStringTag, {
       get: function get() {