https://github.com/sergei-startsev/karma-stacktrace

Provides human-readable sourcemapped stacktrace for running tests in a browser.
https://github.com/sergei-startsev/karma-stacktrace

jasmine qunit sourcemaps stacktrace

Last synced: 8 days ago
JSON representation

Provides human-readable sourcemapped stacktrace for running tests in a browser.

• Host: GitHub
• URL: https://github.com/sergei-startsev/karma-stacktrace
• Owner: sergei-startsev
• License: mit
• Created: 2017-06-11T18:07:25.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-06-20T11:23:33.000Z (5 months ago)
• Last Synced: 2024-10-18T15:05:37.445Z (18 days ago)
• Topics: jasmine, qunit, sourcemaps, stacktrace
• Language: JavaScript
• Homepage:
• Size: 445 KB
• Stars: 4
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# karma-stacktrace

![actions](https://github.com/sergei-startsev/karma-stacktrace/workflows/Node%20CI/badge.svg)

![npm](https://img.shields.io/npm/v/karma-stacktrace)

![GitHub](https://img.shields.io/github/license/sergei-startsev/karma-stacktrace)

## What

Karma framework to provide human-readable mapped stacktraces for failed tests to make debugging easier in your browser.

## Motivation

Test frameworks like [QUnit](https://qunitjs.com/) and [Jasmine](http://jasmine.github.io/) use [non-standard](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/Stack) `stack` property of `Error` object to output a stacktrace for failed unit tests.

Modern browsers do not apply sourcemaps to `Error.prototype.stack` and unmapped stacktrace looks useless.

An example of an unmapped stacktrace:

![Original stacktrace](./stacktrace-original.png 'Original stacktrace')

The framework catches failed tests and reports mapped stacktrace by using [stacktrace-js](https://www.stacktracejs.com/) library:

![Mapped stacktrace](./stacktrace-mapped.png 'Mapped stacktrace')

## Install

Install with `yarn`:

`yarn add karma-stacktrace`

With `npm`:

`npm install karma-stacktrace`

## Karma configuration

Add `stacktrace` to the list of frameworks in your karma configuration:

```js

// karma.conf.js

module.exports = function (config) {

  config.set({

    //...

    frameworks: ['stacktrace']

    //...

  });

};

```

To avoid blocking the main execution thread [web worker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is used by default for parsing/mapping stacktrace,

however you can disable it by setting `useWorker` option to `false`:

```js

// karma.conf.js

module.exports = function (config) {

  config.set({

    //...

    client: {

      stacktrace: {

        useWorker: false

      }

    }

    //...

  });

};

```

If you use inline sourcemaps (`devtool: 'inline-source-map'`) you need to disable the web worker.

## Limitations/Gotchas

- The framework supports [Jasmine](http://jasmine.github.io/) and [QUnit](https://qunitjs.com/) testing frameworks.

- The framework **does not affect** stacktrace in original messages, it attaches isolated reporters to trace mapped stacktrace.

- Set `useWorker` option to `false` value for inline sourcemaps to get mapped stacktrace.

## Examples

See the [karma configuration example](https://github.com/sergei-startsev/karma-stacktrace/tree/master/examples) used with webpack 5 configured to emit external sourcemaps (`devtool: 'source-map'`).

## Inspired by

- [sourcemapped-stacktrace](https://github.com/novocaine/sourcemapped-stacktrace)