[New] add customInspect option, to disable custom inspect methods

Author: ljharb

index.js

@@ -33,6 +33,10 @@ module.exports = function inspect_(obj, options, depth, seen) {
     ) {
         throw new TypeError('option "maxStringLength", if provided, must be a positive integer, Infinity, or `null`');
     }
+    var customInspect = has(opts, 'customInspect') ? opts.customInspect : true;
+    if (typeof customInspect !== 'boolean') {
+        throw new TypeError('option "customInspect", if provided, must be `true` or `false`');
+    }
 
     if (typeof obj === 'undefined') {
         return 'undefined';
@@ -105,7 +109,7 @@ module.exports = function inspect_(obj, options, depth, seen) {
         if (parts.length === 0) { return '[' + String(obj) + ']'; }
         return '{ [' + String(obj) + '] ' + parts.join(', ') + ' }';
     }
-    if (typeof obj === 'object') {
+    if (typeof obj === 'object' && customInspect) {
         if (inspectSymbol && typeof obj[inspectSymbol] === 'function') {
             return obj[inspectSymbol]();
         } else if (typeof obj.inspect === 'function') {

readme.markdown

@@ -44,8 +44,9 @@ var inspect = require('object-inspect')
 Return a string `s` with the string representation of `obj` up to a depth of `opts.depth`.
 
 Additional options:
-  - `quoteStyle`: must be "single" or "double", if present
-  - `maxStringLength`: must be `0`, a positive integer, `Infinity`, or `null`, if present
+  - `quoteStyle`: must be "single" or "double", if present. Default `'single'` for strings, `'double'` for HTML elements.
+  - `maxStringLength`: must be `0`, a positive integer, `Infinity`, or `null`, if present. Default `Infinity`.
+  - `customInspect`: When `true`, a custom inspect method function will be invoked. Default `true`.
 
 # install
 

test/inspect.js

@@ -6,18 +6,22 @@ var repeat = require('string.prototype.repeat');
 var inspect = require('..');
 
 test('inspect', function (t) {
-    t.plan(1);
-    var obj = [{ inspect: function () { return '!XYZ¡'; } }, []];
+    t.plan(3);
+    var obj = [{ inspect: function xyzInspect() { return '!XYZ¡'; } }, []];
     t.equal(inspect(obj), '[ !XYZ¡, [] ]');
+    t.equal(inspect(obj, { customInspect: true }), '[ !XYZ¡, [] ]');
+    t.equal(inspect(obj, { customInspect: false }), '[ { inspect: [Function: xyzInspect] }, [] ]');
 });
 
-test('inspect custom symbol', { skip: !hasSymbols || !utilInspect }, function (t) {
-    t.plan(1);
+test('inspect custom symbol', { skip: !hasSymbols || !utilInspect || !utilInspect.custom }, function (t) {
+    t.plan(3);
 
-    var obj = { inspect: function () { return 'string'; } };
-    obj[utilInspect.custom] = function () { return 'symbol'; };
+    var obj = { inspect: function stringInspect() { return 'string'; } };
+    obj[utilInspect.custom] = function custom() { return 'symbol'; };
 
     t.equal(inspect([obj, []]), '[ ' + (utilInspect.custom ? 'symbol' : 'string') + ', [] ]');
+    t.equal(inspect([obj, []], { customInspect: true }), '[ ' + (utilInspect.custom ? 'symbol' : 'string') + ', [] ]');
+    t.equal(inspect([obj, []], { customInspect: false }), '[ { inspect: [Function: stringInspect] }, [] ]');
 });
 
 test('maxStringLength', function (t) {