https://github.com/stacktracejs/error-stack-parser

Extract meaning from JS Errors
https://github.com/stacktracejs/error-stack-parser

error-handling javascript stacktracejs

Last synced: 8 months ago
JSON representation

Extract meaning from JS Errors

• Host: GitHub
• URL: https://github.com/stacktracejs/error-stack-parser
• Owner: stacktracejs
• License: mit
• Created: 2013-12-07T23:23:28.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2023-01-27T10:34:31.000Z (almost 3 years ago)
• Last Synced: 2025-05-13T13:11:06.173Z (8 months ago)
• Topics: error-handling, javascript, stacktracejs
• Language: JavaScript
• Homepage: https://www.stacktracejs.com/#!/docs/error-stack-parser
• Size: 6.94 MB
• Stars: 472
• Watchers: 17
• Forks: 53
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
error-stack-parser.js - Extract meaning from JS Errors

===============

[![Build Status](https://img.shields.io/github/workflow/status/stacktracejs/error-stack-parser/Continuous%20Integration/master?logo=github&style=flat-square)](https://github.com/stacktracejs/error-stack-parser/actions?query=workflow%3AContinuous+Integration+branch%3Amaster)

[![Coverage Status](https://img.shields.io/coveralls/stacktracejs/error-stack-parser.svg?style=flat-square)](https://coveralls.io/r/stacktracejs/error-stack-parser?branch=master)

[![GitHub license](https://img.shields.io/github/license/stacktracejs/error-stack-parser.svg?style=flat-square)](https://opensource.org/licenses/MIT)

[![size with dependencies](https://img.shields.io/badge/size-4.8k-green.svg?style=flat-square)](https://github.com/stacktracejs/error-stack-parser/releases)

[![gzip size](https://img.shields.io/badge/gzipped-1.8k-green.svg?style=flat-square)](https://github.com/stacktracejs/error-stack-parser/releases)

[![module format](https://img.shields.io/badge/module%20format-umd-lightgrey.svg?style=flat-square&colorB=ff69b4)](https://github.com/stacktracejs/error-stack-parser/releases)

[![code of conduct](https://img.shields.io/badge/code%20of-conduct-lightgrey.svg?style=flat-square&colorB=ff69b4)](http://todogroup.org/opencodeofconduct/#stacktrace.js/me@eriwen.com)

[![jsDelivr Hits](https://data.jsdelivr.com/v1/package/npm/error-stack-parser/badge)](https://www.jsdelivr.com/package/npm/error-stack-parser)

Simple, cross-browser [Error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) parser.

This library parses and extracts function names, URLs, line numbers, and column numbers from the given Error's `stack` as

an Array of [StackFrame](http://git.io/stackframe)s. 

Once you have parsed out StackFrames, you can do much more interesting things. See [stacktrace-gps](http://git.io/stacktrace-gps).

Note that in IE9 and earlier, `Error` objects don't have enough information to extract much of anything. In IE 10, `Error`s

are given a `stack` once they're `throw`n.

## Browser Support

[![Sauce Test Status](https://saucelabs.com/browser-matrix/stacktracejs.svg)](https://saucelabs.com/u/stacktracejs)

## Usage

```js

ErrorStackParser.parse(new Error('BOOM'));

=> [

        StackFrame({functionName: 'foo', args: [], fileName: 'path/to/file.js', lineNumber: 35, columnNumber: 79, isNative: false, isEval: false}),

        StackFrame({functionName: 'Bar', fileName: 'https://cdn.somewherefast.com/utils.min.js', lineNumber: 1, columnNumber: 832, isNative: false, isEval: false, isConstructor: true}),

        StackFrame(... and so on ...)

   ]

```

## Installation

```bash

npm install error-stack-parser

bower install error-stack-parser

https://raw.githubusercontent.com/stacktracejs/error-stack-parser/master/dist/error-stack-parser.min.js

```

## Contributing

Want to be listed as a *Contributor*? Start with the [Contributing Guide](.github/CONTRIBUTING.md)!