useInsertionEffect other use-case

Hello,

in the docs it is stated that useInsertionEffect should be used only by css-in-js library authors, I think I've came across an other use case. I'm using forwardRef with a type HTMLDivElement[] where through a callback ref I'm pushing the refs in to the array as so ref={(ref) => ref && innerRef.current.push(ref)} and syncing it outside with a useImperativeHandle

However this needs a cleanup whenever the component re-renders, since useInsertionEffect fires sync BEFORE the dom is mutated, it is perfect for the cleanup of the innerRef array.

The code is as follows

const ComponentReturningAnArray = React.forwardRef<HTMLDivElement[], { data: string[] }>(({array}, outerRef) => {
const innerRef = useRef<HTMLDivElement[]>([]);

useImperativeHandle<HTMLDivElement[], HTMLDivElement[]>(outerRef, () => innerRef.current, [innerRef.current]);

useInsertionEffect(() => {
    innerRef.current = [];
  });

return (
     <>
        {
             data.map((d) => (<div ref={(ref) => ref && innerRef.current.push(ref)}>{d}</div>))
        }
    </>
)
});

Beginne mit der Dokumentationsaussage zu useInsertionEffect und dem bereitgestellten ComponentReturningAnArray-Beispiel. Prüfe, ob diese Bereinigung der Ref-Sammlung ein beabsichtigter Anwendungsfall ist, und bestimme, wie die Dokumentation dies beschreiben sollte. Die Aufgabe ist erledigt, wenn die Anleitung die unterstützten Anwendungsfälle korrekt wiedergibt und das Beispiel berücksichtigt wird.