Skip to content

Conversation

@chrisdavidmills
Copy link
Contributor

Description

Use of the bgra8unorm format for read-only storage textures is deprecated. The specification explicitly disallows this, as this format is intended for write-only access and is not portable. Any browser support for this combination is considered a bug.

Chrome previously allowed this, but it is deprecated from version 140 onwards. See https://developer.chrome.com/blog/new-in-webgpu-140#deprecate_bgra8unorm_read-only_storage_texture_usage.

This PR adds a note to make the deprecation clear. Note that I'm not intending to add a browser compat data point for this change, as:

  • It is expected behavior anyway.
  • We don't really want to encourage people to use it in browsers that wrongly allow it.

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner November 7, 2025 15:14
@chrisdavidmills chrisdavidmills requested review from wbamberg and removed request for a team November 7, 2025 15:14
@github-actions github-actions bot added the Content:WebAPI Web API docs label Nov 7, 2025
@chrisdavidmills chrisdavidmills changed the title Add note about bgra8unorm read-only storage textures bring deprecated Tech review: Add note about bgra8unorm read-only storage textures bring deprecated Nov 7, 2025
@github-actions github-actions bot added the size/xs [PR only] 0-5 LoC changed label Nov 7, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 7, 2025

@chrisdavidmills chrisdavidmills changed the title Tech review: Add note about bgra8unorm read-only storage textures bring deprecated Editorial review: Add note about bgra8unorm read-only storage textures bring deprecated Nov 7, 2025
@chrisdavidmills
Copy link
Contributor Author

@beaufortfrancois looked at this and approved over chat, so moving to editorial review.

Copy link
Collaborator

@wbamberg wbamberg left a comment

Choose a reason for hiding this comment

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

👍

@wbamberg wbamberg merged commit aaca263 into mdn:main Nov 20, 2025
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/xs [PR only] 0-5 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants