Image block: caption persists when replacing image

[afercia]

Description

When replacing an image that does have a caption with another image that does not have a caption, the previous caption persists.

I can reproduce thie behavior on WordPress 6.5 and on Gutenberg trunk.

Attached animated GIF to illustrate:

Step-by-step reproduction instructions

• Create a new post.
• Add an Image block from the Media Library, make sure the image does have a caption.
• Observe the image does render its caption.
• Click 'Replace' in the image block toolbar.
• Replace the image with one that does not have a caption.
• Observe the caption of the previous image persists.
• Expected: the caption to not be redered.

Note: when replacing with an image that does have a caption, the caption is correctly updated.

Screenshots, screen recording, code snippet

No response

Environment info

No response

Please confirm that you have searched existing issues in the repo.

Yes

Please confirm that you have tested with all plugins deactivated except Gutenberg.

Yes

[t-hamano]

I think this is because there's a process to ensure that caption text isn't overwritten by an empty caption.

gutenberg/packages/block-library/src/image/edit.js

Lines 197 to 203 in fe8fe40

	// If a caption text was meanwhile written by the user,
	// make sure the text is not overwritten by empty captions.
	if ( captionRef.current && ! mediaAttributes.caption ) {
	const { caption: omittedCaption, ...restMediaAttributes } =
	mediaAttributes;
	mediaAttributes = restMediaAttributes;
	}

Do you think this process is unnecessary?

[afercia]

I understand the intent of that check but seems to me it is based on an assumption. To me, it is only valid in a scenario where the user has written a new caption and it is still making a decision on what image to use or wants to replace the image with one that fits with the existing caption. Maybe they are trying various images and in that case it makes sense to not lose the caption. But this is an assumption on a single case.

As a user, when I replace an image with a new one that has its own caption, I expect the caption to be there.

Edit: Also, comparing the behavior with the one that always existed in WordPress and now it's in the Classic editor, this is a change in the expected behavior that should have been considered a little more deeply IMHO.