[Suggestion]: Section "Queueing a Series of State Updates": await in event handler cause immediate rerender

Summary

The documentation says here: "React waits until all code in the event handlers has run before processing your state updates"

This not the case when using await inside the handler!

Example

const [myNumber, setMyNumber] = useState(0);

async function handleClick(){
    setMyNumber(i => i + 1);
    await delay(100);
    setMyNumber(i => i + 1);
}

function delay(ms) {
    return new Promise(resolve => {
        setTimeout(resolve, ms);
    });
}

This will rerender the component twice!

Page

https://react.dev/learn/queueing-a-series-of-state-updates

Details

I suggest it should be mentioned as caveat/pitfall that if you call await inside an event handler,
all changes made to states before that await will then be flushed and trigger a rerender immediately, not waiting
for the event handler to finish completely.

Lisez la page « Queueing a Series of State Updates » liée dans l’issue et reproduisez l’exemple d’event-handler asynchrone fourni afin de confirmer le comportement. Mettez cette page à jour avec une remarque expliquant que les mises à jour d’état effectuées avant un await peuvent être flushées avant la fin du handler ; le travail est terminé lorsque l’exemple et les indications concernant le batching sont exacts et clairs.