https://github.com/sindresorhus/p-try

Start a promise chain
https://github.com/sindresorhus/p-try

Last synced: about 2 months ago
JSON representation

Start a promise chain

• Host: GitHub
• URL: https://github.com/sindresorhus/p-try
• Owner: sindresorhus
• License: mit
• Created: 2016-10-21T06:03:45.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2021-10-04T16:19:45.000Z (over 2 years ago)
• Last Synced: 2024-04-13T17:39:44.528Z (3 months ago)
• Language: JavaScript
• Homepage:
• Size: 13.7 KB
• Stars: 50
• Watchers: 6
• Forks: 12
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md
  • Funding: .github/funding.yml
  • License: license
  • Security: .github/security.md

Lists

• awesome-promises - p-try - `Promise#try()` ponyfill - Starts a promise chain (Convenience Utilities / sindresorhus's many Promise utilities ([see notes](https://github.com/sindresorhus/promise-fun)))
• promise-fun - p-try - Starts a promise chain (Packages)

README

        
# p-try

> Start a promise chain

[How is it useful?](http://cryto.net/~joepie91/blog/2016/05/11/what-is-promise-try-and-why-does-it-matter/)

## Install

```sh

npm install p-try

```

## Usage

```js

import pTry from 'p-try';

try {

	const value = await pTry(() => {

		return synchronousFunctionThatMightThrow();

	});

	console.log(value);

} catch (error) {

	console.error(error);

}

```

## API

### pTry(fn, ...arguments)

Returns a `Promise` resolved with the value of calling `fn(...arguments)`. If the function throws an error, the returned `Promise` will be rejected with that error.

Support for passing arguments on to the `fn` is provided in order to be able to avoid creating unnecessary closures. You probably don't need this optimization unless you're pushing a *lot* of functions.

#### fn

The function to run to start the promise chain.

#### arguments

Arguments to pass to `fn`.

## Related

- [More…](https://github.com/sindresorhus/promise-fun)

---



	

		Get professional support for this package with a Tidelift subscription

	

	


	

		Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies.