1 | # object-inspect <sup>[![Version Badge][npm-version-svg]][package-url]</sup>
|
---|
2 |
|
---|
3 | string representations of objects in node and the browser
|
---|
4 |
|
---|
5 | [![github actions][actions-image]][actions-url]
|
---|
6 | [![coverage][codecov-image]][codecov-url]
|
---|
7 | [![License][license-image]][license-url]
|
---|
8 | [![Downloads][downloads-image]][downloads-url]
|
---|
9 |
|
---|
10 | [![npm badge][npm-badge-png]][package-url]
|
---|
11 |
|
---|
12 | # example
|
---|
13 |
|
---|
14 | ## circular
|
---|
15 |
|
---|
16 | ``` js
|
---|
17 | var inspect = require('object-inspect');
|
---|
18 | var obj = { a: 1, b: [3,4] };
|
---|
19 | obj.c = obj;
|
---|
20 | console.log(inspect(obj));
|
---|
21 | ```
|
---|
22 |
|
---|
23 | ## dom element
|
---|
24 |
|
---|
25 | ``` js
|
---|
26 | var inspect = require('object-inspect');
|
---|
27 |
|
---|
28 | var d = document.createElement('div');
|
---|
29 | d.setAttribute('id', 'beep');
|
---|
30 | d.innerHTML = '<b>wooo</b><i>iiiii</i>';
|
---|
31 |
|
---|
32 | console.log(inspect([ d, { a: 3, b : 4, c: [5,6,[7,[8,[9]]]] } ]));
|
---|
33 | ```
|
---|
34 |
|
---|
35 | output:
|
---|
36 |
|
---|
37 | ```
|
---|
38 | [ <div id="beep">...</div>, { a: 3, b: 4, c: [ 5, 6, [ 7, [ 8, [ ... ] ] ] ] } ]
|
---|
39 | ```
|
---|
40 |
|
---|
41 | # methods
|
---|
42 |
|
---|
43 | ``` js
|
---|
44 | var inspect = require('object-inspect')
|
---|
45 | ```
|
---|
46 |
|
---|
47 | ## var s = inspect(obj, opts={})
|
---|
48 |
|
---|
49 | Return a string `s` with the string representation of `obj` up to a depth of `opts.depth`.
|
---|
50 |
|
---|
51 | Additional options:
|
---|
52 | - `quoteStyle`: must be "single" or "double", if present. Default `'single'` for strings, `'double'` for HTML elements.
|
---|
53 | - `maxStringLength`: must be `0`, a positive integer, `Infinity`, or `null`, if present. Default `Infinity`.
|
---|
54 | - `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`.
|
---|
55 | - `indent`: must be "\t", `null`, or a positive integer. Default `null`.
|
---|
56 | - `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'`)
|
---|
57 |
|
---|
58 | # install
|
---|
59 |
|
---|
60 | With [npm](https://npmjs.org) do:
|
---|
61 |
|
---|
62 | ```
|
---|
63 | npm install object-inspect
|
---|
64 | ```
|
---|
65 |
|
---|
66 | # license
|
---|
67 |
|
---|
68 | MIT
|
---|
69 |
|
---|
70 | [package-url]: https://npmjs.org/package/object-inspect
|
---|
71 | [npm-version-svg]: https://versionbadg.es/inspect-js/object-inspect.svg
|
---|
72 | [deps-svg]: https://david-dm.org/inspect-js/object-inspect.svg
|
---|
73 | [deps-url]: https://david-dm.org/inspect-js/object-inspect
|
---|
74 | [dev-deps-svg]: https://david-dm.org/inspect-js/object-inspect/dev-status.svg
|
---|
75 | [dev-deps-url]: https://david-dm.org/inspect-js/object-inspect#info=devDependencies
|
---|
76 | [npm-badge-png]: https://nodei.co/npm/object-inspect.png?downloads=true&stars=true
|
---|
77 | [license-image]: https://img.shields.io/npm/l/object-inspect.svg
|
---|
78 | [license-url]: LICENSE
|
---|
79 | [downloads-image]: https://img.shields.io/npm/dm/object-inspect.svg
|
---|
80 | [downloads-url]: https://npm-stat.com/charts.html?package=object-inspect
|
---|
81 | [codecov-image]: https://codecov.io/gh/inspect-js/object-inspect/branch/main/graphs/badge.svg
|
---|
82 | [codecov-url]: https://app.codecov.io/gh/inspect-js/object-inspect/
|
---|
83 | [actions-image]: https://img.shields.io/endpoint?url=https://github-actions-badge-u3jn4tfpocch.runkit.sh/inspect-js/object-inspect
|
---|
84 | [actions-url]: https://github.com/inspect-js/object-inspect/actions
|
---|