React Example: UseQueuedValue
tsx
import ReactDOM from 'react-dom/client'
import { useQueuedValue } from '@tanstack/react-pacer/queuer'
import { useState } from 'react'
function App1() {
const [instantSearchValue, setInstantSearchValue] = useState('')
// Queuer that processes a single value with delays
const [value, queuer] = useQueuedValue(instantSearchValue, {
maxSize: 25,
started: false,
wait: 500, // wait 500ms between processing value changes
})
return (
<div>
<h1>TanStack Pacer useQueuedValue Example 1</h1>
<div>Current Value: {value}</div>
<hr />
<div>Queue Size: {queuer.getSize()}</div>
<div>Queue Full: {queuer.getIsFull() ? 'Yes' : 'No'}</div>
<div>Queue Peek: {queuer.getPeek()}</div>
<div>Queue Empty: {queuer.getIsEmpty() ? 'Yes' : 'No'}</div>
<div>Queue Idle: {queuer.getIsIdle() ? 'Yes' : 'No'}</div>
<div>Queuer Status: {queuer.getIsRunning() ? 'Running' : 'Stopped'}</div>
<div>Items Processed: {queuer.getExecutionCount()}</div>
<div>Queue Items: {queuer.getAllItems().join(', ')}</div>
<div
style={{
display: 'grid',
gridTemplateColumns: 'repeat(2, 1fr)',
gap: '8px',
maxWidth: '600px',
margin: '16px 0',
}}
>
<input
autoFocus
type="search"
value={instantSearchValue}
onChange={(e) => {
setInstantSearchValue(e.target.value) // instantly update the local search value
}}
placeholder="Enter search term..."
disabled={queuer.getIsFull()}
/>
<button
disabled={queuer.getIsEmpty()}
onClick={() => {
const item = queuer.getNextItem()
console.log('getNextItem item', item)
}}
>
Process Next
</button>
<button onClick={() => queuer.clear()} disabled={queuer.getIsEmpty()}>
Clear Queue
</button>
<button onClick={() => queuer.reset()} disabled={queuer.getIsEmpty()}>
Reset Queue
</button>
<button onClick={() => queuer.start()} disabled={queuer.getIsRunning()}>
Start Processing
</button>
<button onClick={() => queuer.stop()} disabled={!queuer.getIsRunning()}>
Stop Processing
</button>
</div>
</div>
)
}
function App2() {
const [currentValue, setCurrentValue] = useState(50)
const [instantExecutionCount, setInstantExecutionCount] = useState(0)
// Queuer that processes a single value with delays
const [queuedValue, queuer] = useQueuedValue(currentValue, {
maxSize: 100,
wait: 100,
})
function handleRangeChange(e: React.ChangeEvent<HTMLInputElement>) {
const newValue = parseInt(e.target.value, 10)
setCurrentValue(newValue)
setInstantExecutionCount((c) => c + 1)
}
return (
<div>
<h1>TanStack Pacer useQueuedValue Example 2</h1>
<div style={{ marginBottom: '20px' }}>
<label>
Current Range:
<input
type="range"
min="0"
max="100"
value={currentValue}
onChange={handleRangeChange}
style={{ width: '100%' }}
/>
<span>{currentValue}</span>
</label>
</div>
<div style={{ marginBottom: '20px' }}>
<label>
Queued Range (Readonly):
<input
type="range"
min="0"
max="100"
value={queuedValue}
readOnly
style={{ width: '100%' }}
/>
<span>{queuedValue}</span>
</label>
</div>
<table>
<tbody>
<tr>
<td>Queue Size:</td>
<td>{queuer.getSize()}</td>
</tr>
<tr>
<td>Queue Full:</td>
<td>{queuer.getIsFull() ? 'Yes' : 'No'}</td>
</tr>
<tr>
<td>Queue Empty:</td>
<td>{queuer.getIsEmpty() ? 'Yes' : 'No'}</td>
</tr>
<tr>
<td>Queue Idle:</td>
<td>{queuer.getIsIdle() ? 'Yes' : 'No'}</td>
</tr>
<tr>
<td>Queuer Status:</td>
<td>{queuer.getIsRunning() ? 'Running' : 'Stopped'}</td>
</tr>
<tr>
<td>Instant Executions:</td>
<td>{instantExecutionCount}</td>
</tr>
<tr>
<td>Items Processed:</td>
<td>{queuer.getExecutionCount()}</td>
</tr>
<tr>
<td>Saved Executions:</td>
<td>{instantExecutionCount - queuer.getExecutionCount()}</td>
</tr>
<tr>
<td>% Reduction:</td>
<td>
{instantExecutionCount === 0
? '0'
: Math.round(
((instantExecutionCount - queuer.getExecutionCount()) /
instantExecutionCount) *
100,
)}
%
</td>
</tr>
</tbody>
</table>
<div style={{ color: '#666', fontSize: '0.9em' }}>
<p>Queued with 100ms wait time</p>
</div>
</div>
)
}
const root = ReactDOM.createRoot(document.getElementById('root')!)
root.render(
<div>
<App1 />
<hr />
<App2 />
</div>,
)
import ReactDOM from 'react-dom/client'
import { useQueuedValue } from '@tanstack/react-pacer/queuer'
import { useState } from 'react'
function App1() {
const [instantSearchValue, setInstantSearchValue] = useState('')
// Queuer that processes a single value with delays
const [value, queuer] = useQueuedValue(instantSearchValue, {
maxSize: 25,
started: false,
wait: 500, // wait 500ms between processing value changes
})
return (
<div>
<h1>TanStack Pacer useQueuedValue Example 1</h1>
<div>Current Value: {value}</div>
<hr />
<div>Queue Size: {queuer.getSize()}</div>
<div>Queue Full: {queuer.getIsFull() ? 'Yes' : 'No'}</div>
<div>Queue Peek: {queuer.getPeek()}</div>
<div>Queue Empty: {queuer.getIsEmpty() ? 'Yes' : 'No'}</div>
<div>Queue Idle: {queuer.getIsIdle() ? 'Yes' : 'No'}</div>
<div>Queuer Status: {queuer.getIsRunning() ? 'Running' : 'Stopped'}</div>
<div>Items Processed: {queuer.getExecutionCount()}</div>
<div>Queue Items: {queuer.getAllItems().join(', ')}</div>
<div
style={{
display: 'grid',
gridTemplateColumns: 'repeat(2, 1fr)',
gap: '8px',
maxWidth: '600px',
margin: '16px 0',
}}
>
<input
autoFocus
type="search"
value={instantSearchValue}
onChange={(e) => {
setInstantSearchValue(e.target.value) // instantly update the local search value
}}
placeholder="Enter search term..."
disabled={queuer.getIsFull()}
/>
<button
disabled={queuer.getIsEmpty()}
onClick={() => {
const item = queuer.getNextItem()
console.log('getNextItem item', item)
}}
>
Process Next
</button>
<button onClick={() => queuer.clear()} disabled={queuer.getIsEmpty()}>
Clear Queue
</button>
<button onClick={() => queuer.reset()} disabled={queuer.getIsEmpty()}>
Reset Queue
</button>
<button onClick={() => queuer.start()} disabled={queuer.getIsRunning()}>
Start Processing
</button>
<button onClick={() => queuer.stop()} disabled={!queuer.getIsRunning()}>
Stop Processing
</button>
</div>
</div>
)
}
function App2() {
const [currentValue, setCurrentValue] = useState(50)
const [instantExecutionCount, setInstantExecutionCount] = useState(0)
// Queuer that processes a single value with delays
const [queuedValue, queuer] = useQueuedValue(currentValue, {
maxSize: 100,
wait: 100,
})
function handleRangeChange(e: React.ChangeEvent<HTMLInputElement>) {
const newValue = parseInt(e.target.value, 10)
setCurrentValue(newValue)
setInstantExecutionCount((c) => c + 1)
}
return (
<div>
<h1>TanStack Pacer useQueuedValue Example 2</h1>
<div style={{ marginBottom: '20px' }}>
<label>
Current Range:
<input
type="range"
min="0"
max="100"
value={currentValue}
onChange={handleRangeChange}
style={{ width: '100%' }}
/>
<span>{currentValue}</span>
</label>
</div>
<div style={{ marginBottom: '20px' }}>
<label>
Queued Range (Readonly):
<input
type="range"
min="0"
max="100"
value={queuedValue}
readOnly
style={{ width: '100%' }}
/>
<span>{queuedValue}</span>
</label>
</div>
<table>
<tbody>
<tr>
<td>Queue Size:</td>
<td>{queuer.getSize()}</td>
</tr>
<tr>
<td>Queue Full:</td>
<td>{queuer.getIsFull() ? 'Yes' : 'No'}</td>
</tr>
<tr>
<td>Queue Empty:</td>
<td>{queuer.getIsEmpty() ? 'Yes' : 'No'}</td>
</tr>
<tr>
<td>Queue Idle:</td>
<td>{queuer.getIsIdle() ? 'Yes' : 'No'}</td>
</tr>
<tr>
<td>Queuer Status:</td>
<td>{queuer.getIsRunning() ? 'Running' : 'Stopped'}</td>
</tr>
<tr>
<td>Instant Executions:</td>
<td>{instantExecutionCount}</td>
</tr>
<tr>
<td>Items Processed:</td>
<td>{queuer.getExecutionCount()}</td>
</tr>
<tr>
<td>Saved Executions:</td>
<td>{instantExecutionCount - queuer.getExecutionCount()}</td>
</tr>
<tr>
<td>% Reduction:</td>
<td>
{instantExecutionCount === 0
? '0'
: Math.round(
((instantExecutionCount - queuer.getExecutionCount()) /
instantExecutionCount) *
100,
)}
%
</td>
</tr>
</tbody>
</table>
<div style={{ color: '#666', fontSize: '0.9em' }}>
<p>Queued with 100ms wait time</p>
</div>
</div>
)
}
const root = ReactDOM.createRoot(document.getElementById('root')!)
root.render(
<div>
<App1 />
<hr />
<App2 />
</div>,
)
Subscribe to Bytes
Your weekly dose of JavaScript news. Delivered every Monday to over 100,000 devs, for free.