feat(debounce): Support AbortSignal to debounce for improved cancellation

[Hanna922]

Hi👋🏻 I have reviewed issue #37 and thought it was a good feature, so I have added it.

The debounce function already supports cancellation through its return value, but its usability would improve if it also supported cancellation via AbortSignal, which is implemented in all major web browsers and JavaScript runtimes.

If this change is acceptable, I'll add docs and extend this functionality to the delay function.

Before

function debounce<F extends (...args: any[]) => void>(func: F, debounceMs: number): F & { cancel: () => void }

After

function debounce<F extends (...args: any[]) => void>(
  func: F,
  debounceMs: number,
  abortSignal?: AbortSignal
): F & { cancel: () => void }

[vercel]

@Hanna922 is attempting to deploy a commit to the Toss Team on Vercel.

A member of the Team first needs to authorize it.

[raon0211]

Hello @Hanna922, Thanks for your contribution!

[raon0211]

To receive signals, what about we follow the fetch API's option? It would be helpful when we add new options to our debounce function.

interface DebounceOptions {
  signal?: AbortSignal;
}

export function debounce<F extends (...args: any[]) => void>(
  func: F,
  debounceMs: number,
  { signal }: DebounceOptions = {}
) { /* ... */ }

[Hanna922]

It was applied in b6ed097

[raon0211]

Suggested change

	if (abortSignal) {
	abortSignal.removeEventListener('abort', onAbort);
	}
	abortSignal?.removeEventListener('abort', onAbort);

What about using optional chaining here?

[raon0211]

Suggested change

	if (abortSignal) {
	abortSignal.addEventListener('abort', onAbort);
	}
	abortSignal?.addEventListener('abort', onAbort);

Here too

[Hanna922]

It was applied in 8cf4772

[Hanna922]

@raon0211 I have applied the comments and added docs! Thank you 🙇🏻‍♀️

[raon0211]

Awesome work!