Skip to content

[wip] Add optimisticKey docs#8326

Draft
rickhanlonii wants to merge 1 commit intoreactjs:mainfrom
rickhanlonii:rh/optimistic-key-docs
Draft

[wip] Add optimisticKey docs#8326
rickhanlonii wants to merge 1 commit intoreactjs:mainfrom
rickhanlonii:rh/optimistic-key-docs

Conversation

@rickhanlonii
Copy link
Member

WIP - this is only the claude output, which is pretty good but I need to review / verify it.

@github-actions
Copy link

Size changes

Details

📦 Next.js Bundle Analysis for react-dev

This analysis was generated by the Next.js Bundle Analysis action. 🤖

One Page Changed Size

The following page changed size from the code in this PR compared to its base branch:

Page Size (compressed) First Load
/[[...markdownPath]] 128.84 KB (🟡 +13 B) 243.93 KB
Details

Only the gzipped size is provided here based on an expert tip.

First Load is the size of the global bundle plus the bundle for the individual page. If a user were to show up to your website and land on a given page, the first load size represents the amount of javascript that user would need to download. If next/link is used, subsequent page loads would only need to download that page's bundle (the number in the "Size" column), since the global bundle has already been downloaded.

Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis

Next to the size is how much the size has increased or decreased compared with the base branch of this PR. If this percentage has increased by 10% or more, there will be a red status indicator applied, indicating that special attention should be given to this.


return (
<div>
<button onClick={() => handleAddTodo('New todo')}>
Copy link

@MaxwellCohen MaxwellCohen Feb 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It would be nice to have a button to add a todo without using the optimisticKey, so it is easier to see the benefit of this api.


<Experimental>

**This API is experimental and is not available in a stable version of React yet.**

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What feedback does the React team want regarding optimisticKey (and other experimental APIs)?

Some APIs are mostly complete and just need testing for the next release, or for web standards to reach the point where they can be used (like ). Then there are some APIs that edge cases and additional use cases might need to be figured out about (like fragment references).

For optimisticKey it seems like this is an API that needs to be tested before being released in React 19.3 or 20

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants