How to use p-tap with async/await?

p-tap is designed for promise chains, so you need to wrap async functions in promises. For example, use `Promise.resolve(asyncFunction()).then(pTap(...))`, but it's more natural with .then() chains than direct async/await integration.

p-tap vs manual .then() for logging?

p-tap provides a cleaner, declarative way to inject side effects without risking value changes, whereas manual .then() requires careful coding to avoid altering the promise. p-tap reduces boilerplate and potential errors in complex chains.

Does p-tap work with fetch API?

Yes, p-tap works with any promise, including those from fetch. You can chain it after fetch calls to log responses or perform side effects, as shown in the usage examples with Promise.resolve.

How to handle errors with p-tap?

Use pTap.catch() in .catch() methods to tap into errors without affecting error propagation. For instance, `.catch(pTap.catch(console.error))` logs errors while still allowing subsequent error handling.

What are alternatives to p-tap?

Alternatives include native promise methods, libraries like Bluebird with tap, or other utilities from the promise-fun collection. p-tap is minimal, while others might offer more features but with added complexity.

p-tap performance overhead?

p-tap is lightweight, but it adds an extra function call in the promise chain. In performance-critical applications, this overhead might be noticeable, though for most use cases, it's negligible.

Open-Awesome

p-tap

MITJavaScriptv4.0.0

A utility to tap into promise chains for side effects without affecting the promise value or state.

GitHub

134 stars7 forks0 contributors

What is p-tap?

p-tap is a JavaScript utility library that enables developers to tap into promise chains to perform side effects—like logging, debugging, or asynchronous operations—without affecting the promise's resolved value or state. It solves the problem of wanting to observe or execute code during promise execution without breaking the chain's flow.

Target Audience

JavaScript developers working with promise chains who need to inject side effects for debugging, logging, or asynchronous operations without modifying promise values.

Value Proposition

Developers choose p-tap because it provides a clean, focused solution for promise side effects that integrates seamlessly with existing promise chains, unlike manual approaches that can clutter code or alter promise behavior.

Overview

Tap into a promise chain without affecting its value or state

Use Cases

Best For

Logging promise values during debugging without affecting chain results
Recording analytics or stats asynchronously within promise flows
Injecting side effects in functional promise compositions
Error logging in promise chains without interfering with error handling
Debugging complex promise chains with minimal code changes
Performing asynchronous operations alongside main promise logic

Not Ideal For

Projects exclusively using async/await without promise chains
Teams needing side effects to modify promise values (p-tap intentionally preserves them)
Applications with promise libraries that have built-in tap methods, like Bluebird

Pros & Cons

Pros

Non-invasive Side Effects

Allows executing code like logging or async operations without altering the promise's resolved value, as shown in README examples where 'value' remains unchanged after pTap.

Built-in Error Tapping

Includes pTap.catch() for tapping into promise rejections, enabling error logging without interfering with the chain's error handling, demonstrated in the catch example.

Async Handler Support

Automatically awaits promise-returning tap handlers before continuing the chain, ensuring side effects complete, as mentioned in the API section.

Minimal and Focused

Follows the Unix philosophy of doing one thing well, providing a lightweight utility without unnecessary complexity, as stated in the project philosophy.

Cons

Limited to Promise Chains

Not directly compatible with async/await syntax, requiring wrapping or conversion that can add boilerplate code for modern JavaScript projects.

Dependency Overhead for Simple Cases

For basic logging or side effects, using native .then() might suffice, and adding p-tap could introduce an unnecessary dependency in small projects.

Potential Thunk Confusion

The thunk-based API might confuse developers unfamiliar with functional programming concepts, leading to incorrect usage or debugging challenges.

Frequently Asked Questions

Related Projects

p-queue

Promise queue with concurrency control

Stars4,298

Forks227

Last commit6 days ago

p-limit

Run multiple promise-returning & async functions with limited concurrency

Stars2,934

Forks146

Last commit1 month ago

p-map

Map over promises concurrently

Stars1,517

Forks87

Last commit12 days ago

pify

Promisify a callback-style function

Stars1,502

Forks72