Wondering what’s next for npm?Check out our public roadmap! »

    borked

    1.0.1 • Public • Published

    BORKED

    borked: To have broken something so entirely, you break the words used to describe the item.

    borked is a micro utility designed for a very specific use-case. Timing out async functions (caveat: it does not cancel the long running promise).

    When you await an async function or promise in JavaScript it will wait with the executing the rest of the function until async function returns or the promise resolves/rejects. So if it never resolves, completes because it's borked, your whole function will just be waiting indefinitely.

    We solve this by executing your async function/promise with an Promise.race where we will reject the promise when the supplied timeout is reached.

    Installation

    The package in published in the public npm registry and can be installed by running.

    npm install --save borked

    Usage

    import bork from 'borked';
     
    const borked = bork(2000);
     
    //
    // Normally in your code you would do:
    //
    // await example();
    //
    // And wait for the results, with borked you await `borked`
    //
    try { await borked(example()) }
    catch (e) {
      console.log('called after 2000 ms');
    }
    import { borked } from 'borked';
     
    try { await borked(example()) }
    catch (e) {
      console.log('called after 2000 ms');
    }

    License

    MIT

    Install

    npm i borked

    DownloadsWeekly Downloads

    3

    Version

    1.0.1

    License

    MIT

    Unpacked Size

    6.29 kB

    Total Files

    5

    Last publish

    Collaborators

    • avatar