Calling state setter with same value doesn't reliably work as documented

Thank you for the very high standard of documentation on the React website.

There's a bit that's slightly misleading, though. The "functional updates" section of the useState documentation says:

If your update function returns the exact same value as the current state, the subsequent rerender will be skipped completely.

However, if you watch calls to the component function doing the state update, it seems like a render occurs the first time you do that, because the component function gets called that first time. (Once it returns a bail-out means child components aren't called to rerender.) Subsequent times the component sets the same state value, even the component function isn't called (because of a separate "fast" bail-out).

That first time looks like a render to a dev who's read the documentation and expected setting the same value to be a no-op. That's confusing enough to have made @amsterdamharu file this closed bug report and to have made me, independently, come to github to write a bug report as well (but fortunately I found that one first).

Perhaps:

If your update function returns the exact same value as the current state, the subsequent rerender will be skipped completely (although the component function may be called, at least the first time).

...or something like that.

Then when developers see our component function get called even though we did setValue((v) => v);, we'll know it isn't a bug or our misunderstanding something; it's just part of the complexity of React (and there's probably a good reason for it).

Thanks.

Bắt đầu với phần “functional updates” trong tài liệu useState được liên kết và xem lại nhận định về các giá trị state giống hệt nhau. Cập nhật cách diễn đạt để giải thích rằng hàm của component có thể được gọi trong lần cập nhật đầu tiên thành cùng một giá trị, trong khi lần rerender tiếp theo sẽ bị bỏ qua; thay đổi này được hoàn tất khi tài liệu không còn ngụ ý rằng hàm luôn là một no-op.