constdefaultMessage='promise.timedOut'/** * Lets a promise race against a timeout. If the promise settles before the timeout then it will * be the one to use (no matter, whether it has been resolved or rejected). * * Otherwise the timeout promise will be used to either resolve to a message * or reject an error, depending on the used options. * * @param promise {Promise} the promise to race against the timeout * @param timeout {number=}  optional number of milliseconds until timeout, defaults to 1000ms / 1 sec * @param throwIfTimedOut {boolean=} optional flag to either reject (if true) or resolve (if false), defaults to false * @param message {string=} optional message to be resolved/rejected on timeout, defaults to 'promise.timedOut' * @return {Promise<Awaited<unknown>>} */exportconstcreateTimedPromise=(promise,{timeout=1000,throwIfTimedOut=false,message,details}={})=>{lettimeOut=undefinedconstrace=Promise.race([promise,newPromise((resolve,reject)=>{timeOut=setTimeout(()=>{if(throwIfTimedOut){consterror=newError(message||defaultMessage)// I often like to attach contextual information to errors.// This is up to you, whether to do this or noterror.details=detailsreturnreject(error)}else{returnresolve(message||defaultMessage)}},timeout)})])// always clear timeout to prevent weird behaviourrace.finally(()=>clearTimeout(timeOut))returnrace}

// all defaultawaitcreateTimedPromise(newPromise((resolve,reject)=>{...}))// custom timeoutawaitcreateTimedPromise(newPromise((resolve,reject)=>{...}),{timeout:500})// reject if timedoutawaitcreateTimedPromise(newPromise((resolve,reject)=>{...}),{throwIfTimedOut:true})// additional contextawaitcreateTimedPromise(newPromise((resolve,reject)=>{...}),{message:'you lost',details:{foo:'bar'}})