Question 1

How to retry a promise on timeout with p-timeout?

Accepted Answer

Use the fallback option to return a new promise, such as calling p-timeout again with adjusted parameters. The README shows an example where fallback returns pTimeout(delayedPromise(), {milliseconds: 300}) for a retry.

Question 2

p-timeout vs AbortSignal.timeout – which should I use?

Accepted Answer

Use AbortSignal.timeout() for modern APIs like fetch that support abort signals, as it allows the function to clean up resources. p-timeout is better for older Node.js code or when you need fallback functions and custom error handling not provided by native timeouts.

Question 3

Can I use p-timeout in the browser?

Accepted Answer

Yes, but it's primarily designed for Node.js and may require bundling or adaptation. For browser environments, consider using native AbortSignal.timeout() or ensure compatibility with your build system, as p-timeout relies on Node.js timers by default.

Question 4

How to test async code with p-timeout and fake timers like Sinon?

Accepted Answer

Use the customTimers option to pass original setTimeout and clearTimeout functions, as shown in the README example with sinon.useFakeTimers(). This prevents interference and allows controlled timeout testing.

Question 5

What's the difference between p-timeout and the delay library?

Accepted Answer

p-timeout adds timeout control to existing promises, rejecting or handling them after a delay, while delay (a related library by the same author) simply creates a promise that resolves after a specified time without decorating other promises.

Question 6

How to handle custom timeout errors with p-timeout?

Accepted Answer

Use the message option to specify a string, Error instance, or false for no error. For custom errors, sub-class TimeoutError, as demonstrated in the README with class MyCustomError extends TimeoutError.

p-timeout

What is p-timeout?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions