The ultimate sleep() method for Typescript

sleep.ts

export type SleepOptions = {
	signal?: AbortSignal

	/** If set, aborting will not fail the promise but instead fulfil it right away. */
	skipOnAbort?: true
}

export const sleep = (ms: number, options?: SleepOptions) =>
	new Promise<void>((ok, ng) => {
		// deno-lint-ignore prefer-const
		let timeout: number

		const abortHandler = () => {
			clearTimeout(timeout)
			if (options?.skipOnAbort === true) ok()
			else {
				const aborted = new Error(`sleep aborted`)
				aborted.name = 'AbortError'

				ng(aborted)
			}
		}
		options?.signal?.addEventListener('abort', abortHandler)

		timeout = setTimeout(() => {
			options?.signal?.removeEventListener('abort', abortHandler)
			ok()
		}, ms)
	})