object-inspect

What is object-inspect?

The object-inspect npm package is a utility for inspecting JavaScript objects. It is often used for debugging and logging purposes, as it can provide a string representation of an object, including its properties and their values, even if they are not enumerable or are symbols. It can handle various types of JavaScript values, including objects, arrays, functions, and primitives.

What are object-inspect's main functionalities?

Inspecting objects

This feature allows you to get a string representation of an object, which includes all its properties and their values.

var inspect = require('object-inspect');
var obj = { foo: 'bar', baz: 42 };
console.log(inspect(obj));

Inspecting arrays

This feature allows you to get a string representation of an array, including its elements.

var inspect = require('object-inspect');
var arr = ['foo', 'bar', 42];
console.log(inspect(arr));

Inspecting functions

This feature allows you to get a string representation of a function, including its name and the function keyword.

var inspect = require('object-inspect');
function exampleFunc() {}
console.log(inspect(exampleFunc));

Inspecting symbols

This feature allows you to get a string representation of a symbol, including its description.

var inspect = require('object-inspect');
var sym = Symbol('foo');
console.log(inspect(sym));

Inspecting non-enumerable properties

This feature allows you to inspect objects with non-enumerable properties, which are included in the string representation.

var inspect = require('object-inspect');
var obj = Object.create(null, { foo: { value: 'bar', enumerable: false } });
console.log(inspect(obj));

Other packages similar to object-inspect

util-inspect

This package is similar to object-inspect as it provides inspection capabilities for JavaScript objects. It is a part of Node.js's built-in 'util' module and can be used in a similar way to object-inspect. However, it is specific to Node.js and not intended for use in browsers.

pretty-format

Pretty-format is another package that provides similar functionality to object-inspect. It is used by Jest to format JavaScript object structures for display in test results. It offers customizable plugins to handle different data types and can serialize complex objects for snapshot testing.

README

object-inspect

string representations of objects in node and the browser

example

circular

var inspect = require('object-inspect');
var obj = { a: 1, b: [3,4] };
obj.c = obj;
console.log(inspect(obj));

dom element

var inspect = require('object-inspect');

var d = document.createElement('div');
d.setAttribute('id', 'beep');
d.innerHTML = '<b>wooo</b><i>iiiii</i>';

console.log(inspect([ d, { a: 3, b : 4, c: [5,6,[7,[8,[9]]]] } ]));

output:

[ <div id="beep">...</div>, { a: 3, b: 4, c: [ 5, 6, [ 7, [ 8, [ ... ] ] ] ] } ]

methods

var inspect = require('object-inspect')

var s = inspect(obj, opts={})

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. 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 (either undere the util.inspect.custom symbol, or the inspect property). When the string 'symbol', only the symbol method will be invoked. Default true.
• indent: must be "\t", null, or a positive integer. Default null.
• numericSeparator: must be a boolean, if present. Default false. If true, all numbers will be printed with numeric separators (eg, 1234.5678 will be printed as '1_234.567_8')

install

With npm do:

npm install object-inspect

license

MIT

Changelog

v1.13.3 - 2024-11-09

Commits

• [actions] split out node 10-20, and 20+ 44395a8
• [Fix] quoteStyle: properly escape only the containing quotes 5137f8f
• [Refactor] clean up quoteStyle code 450680c
• [Tests] add quoteStyle escaping tests e997c59
• [Dev Deps] update auto-changelog, es-value-fixtures, tape d5a469c
• [Tests] replace aud with npm audit fb7815f
• [Dev Deps] update mock-property 11c817b