An open API service indexing awesome lists of open source software.

https://github.com/xotic750/attempt-x

Invokes function, returning an object of the results.
https://github.com/xotic750/attempt-x

attempt browser javascript nodejs utility

Last synced: 11 months ago
JSON representation

Invokes function, returning an object of the results.

Awesome Lists containing this project

README

          


Travis status


Dependency status


devDependency status


npm version


jsDelivr hits


bettercodehub score


Coverage Status

## attempt-x

Invokes function, returning an object of the results.

### `module.exports(fn, [...args])` ⇒ Object

This method attempts to invoke the function, returning either the result or
the caught error object. Any additional arguments are provided to the
function when it's invoked.

**Kind**: Exported function
**Returns**: Object - Returns an object of the result.

| Param | Type | Description |
| --------- | --------------------- | ------------------------------------------ |
| fn | function | The function to attempt. |
| [...args] | \* | The arguments to invoke the function with. |

**Example**

```js
import attempt from 'attempt-x';

function thrower() {
throw new Error('Threw');
}

attempt(thrower, 1, 2);
// {
// threw: true,
// value: // Error('Threw') object
// }

function sumArgs(a, b) {
return a + b;
}

attempt(sumArgs, 1, 2);
// {
// threw: false,
// value: 3
// }

const thisArg = [];
function pusher(a, b) {
return this.push(a, b);
}

attempt.call(thisArg, pusher, 1, 2);
// {
// threw: false,
// value: 2
// }
// thisArg => [1, 2];
```