fontfaceonload/.grunt/grunt-gh-pages/gh-pages/src/bower_components/qunit/docs/config/QUnit.stack.md

A simple utility to execute a callback when a webfont loads.

---
layout: default
categories: [config]
title: QUnit.stack
description: Returns a single line string representing the stacktrace (call stack)
---

## `QUnit.stack( [ offset = 0 ] )`

Returns a single line string representing the stacktrace (call stack)

| name               | description                          |
|--------------------|--------------------------------------|
| `offset` (number)  | Set the stacktrace line offset. Defaults to `0` |

This method returns a single line string representing the stacktrace from where it was called. According to its offset argument, `QUnit.stack()` will return the correspondent line from the call stack.

The default offset is 0 and will return the current location where it was called.

Not all [browsers support retrieving stracktraces][browsers]. In those, `QUnit.stack()` will return `undefined`.

[browsers]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/Stack#Browser_compatibility

### Example

The stacktrace line can be used on custom assertions and reporters. The following example [logs](/callbacks/QUnit.log) the line of each passing assertion.

```js
QUnit.log( function( details ) {
  if ( details.result ) {

    // 5 is the line reference for the assertion method, not the following line.
    console.log( QUnit.stack( 5 ) );
  }
} );

QUnit.test( "foo", function( assert ) {

  // the log callback will report the position of the following line.
  assert.ok( true );
} );
```