Files
payload/packages/ui/src/hooks/useQueues.ts
Jacob Fletcher ac1e3cf69e feat(ui): form state queues (#11579)
Implements a form state task queue. This will prevent onChange handlers
within the form component from processing unnecessarily often, sometimes
long after the user has stopped making changes. This leads to a
potentially huge number of network requests if those changes were made
slower than the debounce rate. This is especially noticeable on slow
networks.

Does so through a new `useQueue` hook. This hook maintains a stack of
events that need processing but only processes the final event to
arrive. Every time a new event is pushed to the stack, the currently
running process is aborted (if any), and that event becomes the next in
the queue. This results in a shocking reduction in the time it takes
between final change to form state and the final network response, from
~1.5 minutes to ~3 seconds (depending on the scenario, see below).

This likely fixes a number of existing open issues. I will link those
issues here once they are identified and verifiably fixed.

Before:

I'm typing slowly here to ensure my changes aren't debounce by the form.
There are a total of 60 characters typed, triggering 58 network requests
and taking around 1.5 minutes to complete after the final change was
made.


https://github.com/user-attachments/assets/49ba0790-a8f8-4390-8421-87453ff8b650

After:

Here there are a total of 69 characters typed, triggering 11 network
requests and taking only about 3 seconds to complete after the final
change was made.


https://github.com/user-attachments/assets/447f8303-0957-41bd-bb2d-9e1151ed9ec3
2025-03-10 21:25:14 -04:00

49 lines
1.4 KiB
TypeScript

import { useRef } from 'react'
export function useQueues(): {
queueTask: (fn: (signal: AbortSignal) => Promise<void>) => void
} {
const runningTaskRef = useRef<null | Promise<void>>(null)
const queuedTask = useRef<((signal: AbortSignal) => Promise<void>) | null>(null)
const abortControllerRef = useRef<AbortController | null>(null)
const queueTask = (fn: (signal: AbortSignal) => Promise<void>) => {
// Overwrite the queued task every time a new one arrives
queuedTask.current = fn
// If a task is already running, abort it and return
if (runningTaskRef.current !== null) {
if (abortControllerRef.current) {
abortControllerRef.current.abort()
}
return
}
const executeTask = async () => {
while (queuedTask.current) {
const taskToRun = queuedTask.current
queuedTask.current = null // Reset latest task before running
const controller = new AbortController()
abortControllerRef.current = controller
try {
runningTaskRef.current = taskToRun(controller.signal)
await runningTaskRef.current // Wait for the task to complete
} catch (err) {
if (err.name !== 'AbortError') {
console.error('Error in queued function:', err) // eslint-disable-line no-console
}
} finally {
runningTaskRef.current = null
}
}
}
void executeTask()
}
return { queueTask }
}