# deep-awaited

> Promise wrapper to await the deeply nested promises

Latest version **1.0.1** (published 2022-02-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install deep-awaited
pnpm add deep-awaited
yarn add deep-awaited
bun add deep-awaited
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2022-02-19 |
| First published | 2022-02-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 6.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Aleksei Tsikov |
| Maintainers | atsikov |

## Links

- npm: https://www.npmjs.com/package/deep-awaited
- Repository: https://github.com/atsikov/deep-awaited
- Homepage: https://github.com/atsikov/deep-awaited#readme
- Issues: https://github.com/atsikov/deep-awaited/issues
- npm.io page: https://npm.io/package/deep-awaited

## Recent versions

- 1.0.1 (latest) — 2022-02-19
- 1.0.0 — 2022-02-19

## README

# deep-awaited

Tired of nested `await`s? Don't like to assign awaited results to intermediate variables? There's finally a solution!

With `deep-awaited` you can simply chain your calls and get the result with a single line

```js
/* /user/info returns `{ name: "John Doe" }` */
await deepAwaited(fetch("/user/info")).json().name() // resolves to "John Doe"
```

Library is written in ES6 with provided TypeScript definitions. `deep-awaited` is based on Proxy so you will need to polyfill it when targeting old browsers.

## API

`deepAwaited(promise)`

The only method exported from the library. It wraps the provided promise so that you could immediately access properties of a value to be resolved.

### Limitations

- In order to have a nice chaining, each non-function field is wrapped with a function. Same comes to array elements access. If you use TypeScript, the correct function types will be returned from definitions.
- Literal types are not preserved because of primitives rewrapping

## Examples

Access the required field in a fetched json

```js
await deepAwaited(fetch("/user/info")).json().name() // resolves to "John Doe"
```

Parse strings from the request payload

```js
await deepAwaited(fetch("/user/info")).json().name().split(" ")[0]() // resolves to "John"
```

Chain asynchronous calls in end-to-end tests (eg Playwright)

```js
import { queries } from 'playwright-testing-library
const findByRole = (...params) => deepAwaited(queries.findByRole(...params))

await findByRole($document, "button").click()
```

---
_Source: https://npm.io/package/deep-awaited · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._