Gathering detailed insights and metrics for @diahkomalasarinpm/dolores-repellendus-fugiat
Gathering detailed insights and metrics for @diahkomalasarinpm/dolores-repellendus-fugiat
Installations
npm install @diahkomalasarinpm/dolores-repellendus-fugiatDeveloper Guide
BETA
Typescript
No
Module System
CommonJS
Node Version
20.12.2
NPM Version
10.5.0
Releases
Unable to fetch releases
Download Statistics
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
Maintainers
1
Package Meta Information
Latest Version
1.0.0
Package Id
@diahkomalasarinpm/dolores-repellendus-fugiat@1.0.0
Unpacked Size
29.00 kB
Size
10.26 kB
File Count
10
NPM Version
10.5.0
Node Version
20.12.2
Published on
Apr 26, 2024
Total Downloads
Cumulative downloads
Total Downloads
NaN
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
33
@crabas0npm/nihil-alias-sint@crabas0npm/voluptas-ad-vel@diahkomalasarinpm/a-quam-voluptas-qui@diahkomalasarinpm/ad-molestias-fugit-sunt@diahkomalasarinpm/animi-facere-velit-dolorum@diahkomalasarinpm/asperiores-accusantium-minus-quod@diahkomalasarinpm/blanditiis-ullam-a-fugiat@diahkomalasarinpm/consectetur-ad-repudiandae-delectus@diahkomalasarinpm/corporis-a-quam-distinctio@diahkomalasarinpm/corrupti-autem-optio-iure@diahkomalasarinpm/cumque-nesciunt-non-eos@diahkomalasarinpm/debitis-explicabo-sunt-enim@diahkomalasarinpm/debitis-quas-fuga-occaecati@diahkomalasarinpm/deserunt-cupiditate-quos-beatae@diahkomalasarinpm/dolorem-tempore-vitae-animi@diahkomalasarinpm/eveniet-velit-praesentium-dolorem@diahkomalasarinpm/harum-esse-officiis-magnam@diahkomalasarinpm/harum-nihil-exercitationem-delectus@diahkomalasarinpm/illum-molestias-accusantium-rem@diahkomalasarinpm/incidunt-repudiandae-expedita-eos@diahkomalasarinpm/iure-asperiores-perspiciatis-mollitia@diahkomalasarinpm/magnam-incidunt-error-sapiente@diahkomalasarinpm/nesciunt-expedita-rerum-cumque@diahkomalasarinpm/occaecati-incidunt-dolor-accusantium@diahkomalasarinpm/omnis-veritatis-asperiores-recusandae@diahkomalasarinpm/praesentium-accusamus-maiores-autem@diahkomalasarinpm/provident-eaque-consectetur-harum@diahkomalasarinpm/sapiente-quibusdam-repudiandae-eligendi@diahkomalasarinpm/tempora-iusto-voluptates-vero@diahkomalasarinpm/vero-reiciendis-asperiores-magnam@diahkomalasarinpm/voluptate-asperiores-voluptatum-accusantium@diahkomalasarinpm/voluptatem-illum-aperiam-dolores@ffras4vnpm/commodi-vero-assumenda
StackTracey
Parses call stacks. Reads sources. Clean & filtered output. Sourcemaps. Node & browsers.
Why
- Simple
- Works in Node and browsers, *nix and Windows
- Allows hiding library calls / ad-hoc exclusion (via
// @hidemarker) - Provides source text for call locations
- Fetches sources (via get-source)
- Supports both asynchronous and synchronous interfaces (works even in browsers)
- Full sourcemap support
- Extracts useful information from
SyntaxErrorinstances - Pretty printing
What For
- Error overlay UIs for easier front-end development
- Better error reporting for Node projects
- Advanced logging (displaying call locations)
- Assertion printing
How To
1npm install stacktracey
1import StackTracey from 'stacktracey'
Captures the current call stack:
1stack = new StackTracey () // captures the current call stack
Parses stacks from an Error object:
1stack = new StackTracey (error) 2stack = new StackTracey (error.stack) // ...or from raw string
Stores parsed data in .items:
1stack.items.length // num entries 2stack.items[0] // top
...where each item exposes:
1{ 2 beforeParse: <original text>, 3 callee: <function name>, 4 calleeShort: <shortened function name>, 5 file: <full path to file>, // e.g. /Users/john/my_project/node_modules/foobar/main.js 6 fileRelative: <relative path to file>, // e.g. node_modules/foobar/main.js 7 fileShort: <short path to file>, // e.g. foobar/main.js 8 fileName: <file name>, // e.g. main.js 9 line: <line number>, // starts from 1 10 column: <column number>, // starts from 1 11 12 index: /* true if occured in HTML file at index page */, 13 native: /* true if occured in native browser code */, 14 thirdParty: /* true if occured in library code */, 15 hide: /* true if marked as hidden by "// @hide" tag */, 16 syntaxError: /* true if generated from a SyntaxError instance */ 17}
Accessing sources (synchronously, use with caution in browsers):
1stack = stack.withSources () // returns a copy of stack with all items supplied with sources 2top = stack.items[0] // top item
Accessing sources (asynchronously, preferred method in browsers):
1stack = await stack.withSourcesAsync () // returns a copy of stack with all items supplied with sources 2top = stack.items[0] // top item
...or:
1top = stack.withSourceAt (0) // supplies source for an individiual item (by index)
1top = await stack.withSourceAsyncAt (0) // supplies source for an individiual item (by index)
...or:
1top = stack.withSource (stack.items[0]) // supplies source for an individiual item
1top = await stack.withSourceAsync (stack.items[0]) // supplies source for an individiual item
The returned items contain the following additional fields (already mapped through sourcemaps):
1{ 2 ... // all the previously described fields 3 4 line: <original line number>, 5 column: <original column number>, 6 sourceFile: <original source file object>, 7 sourceLine: <original source line text> 8}
To learn about the sourceFile object, read the get-source docs.
Cleaning Output
Synchronously (use with caution in browsers):
1stack = stack.clean ()
...or (asynchronously):
1stack = await stack.cleanAsync ()
It does the following:
- Reads sources (if available)
- Excludes locations marked with the
isThirdPartyflag (library calls) - Excludes locations marked with a
// @hidecomment (user defined exclusion) - Merges repeated lines (via the
.mergeRepeatedLines)
You can customize its behavior by overriding the isClean (entry, index) predicate.
Custom isThirdParty Predicate
You can override the isThirdParty behavior by subclassing StackTracey:
1class MyStackTracey extends StackTracey { 2 3 isThirdParty (path, externalDomain) { // you can use externalDomain to include traces from libs from other domains 4 return (super.isThirdParty (path) // include default behavior 5 || path.includes ('my-lib')) // paths including 'my-lib' will be marked as thirdParty 6 && !path.includes ('jquery') // jquery paths won't be marked as thirdParty 7 } 8} 9 10... 11 12const stack = new MyStackTracey (error).withSources ()
Pretty Printing
1const prettyPrintedString = new StackTracey (error).withSources ().asTable ()
1const prettyPrintedString = (await new StackTracey (error).withSourcesAsync ()).asTable () // asynchronous version
...or (for pretty printing cleaned output):
1const prettyPrintedString = new StackTracey (error).clean ().asTable ()
1const prettyPrintedString = (await new StackTracey (error).cleanAsync ()).asTable () // asynchronous version
It produces a nice compact table layout (thanks to as-table), supplied with source lines (if available):
at shouldBeVisibleInStackTrace test.js:25 const shouldBeVisibleInStackTrace = () => new StackTracey ()
at it test.js:100 const stack = shouldBeVisibleInStackTrace ()
at callFn mocha/lib/runnable.js:326 var result = fn.call(ctx);
at run mocha/lib/runnable.js:319 callFn(this.fn);
at runTest mocha/lib/runner.js:422 test.run(fn);
at mocha/lib/runner.js:528 self.runTest(function(err) {
at next mocha/lib/runner.js:342 return fn();
at mocha/lib/runner.js:352 next(suites.pop());
at next mocha/lib/runner.js:284 return fn();
at <anonymous> mocha/lib/runner.js:320 next(0);
If you find your pretty printed tables undesirably trimmed (or maybe too long to fit in the line), you can provide custom column widths when calling asTable (...or, alternatively, by overriding maxColumnWidths () method):
1stack.asTable ({ 2 callee: 30, 3 file: 60, 4 sourceLine: 80 5})
Using As A Custom Exception Printer In Node
You can even replace the default NodeJS exception printer with this! This is how you can do it:
1process.on ('uncaughtException', e => { /* print the stack here */ }) 2process.on ('unhandledRejection', e => { /* print the stack here */ })
But the most simple way to achieve that is to use the ololog library (that is built upon StackTracey and several other handy libraries coded by me). Check it out, it's pretty awesome and will blow your brains out :)
1const log = require ('ololog').handleNodeErrors () 2 3// you can also print Errors by simply passing them to the log() function
Parsing SyntaxError instances
For example, when trying to require a file named test_files/syntax_error.js:
1// next line contains a syntax error (not a valid JavaScript) 2foo->bar ()
...the pretty printed call stack for the error thrown would be something like:
at (syntax error) test_files/syntax_error.js:2 foo->bar ()
at it test.js:184 try { require ('./test_files/syntax_error.js') }
at runCallback timers.js:781
at tryOnImmediate timers.js:743
at processImmediate [as _immediat timers.js:714
...where the first line is generated from parsing the raw output from the util.inspect call in Node. Unfortunately, this won't work in older versions of Node (v4 and below) as these versions can't provide any meaningful information for a SyntaxError instance.
Array Methods
All StackTracey instances expose map, filter, concat and slice methods. These methods will return mapped, filtered, joined, reversed and sliced StackTracey instances, respectively:
1s = new StackTracey ().slice (1).filter (x => !x.thirdParty) // current stack shifted by 1 and cleaned from library calls 2 3s instanceof StackTracey // true
Extra Stuff
You can compare two locations via this predicate (tests file, line and column for equality):
1StackTracey.locationsEqual (a, b)
To force-reload the sources, you can invalidate the global source cache:
1StackTracey.resetCache ()
Projects That Use StackTracey
- Ololog — a better
console.logfor the log-driven debugging junkies! - CCXT — a cryptocurrency trading library that supports 130+ exchanges
- pnpm — a fast, disk space efficient package manager (faster than npm and Yarn!)
- panic-overlay — a lightweight standalone alternative to
react-error-overlay
No vulnerabilities found.
No security vulnerabilities found.