Skip to content

feat(web): implement image decoding throttling for HTML images#186032

Merged
auto-submit[bot] merged 7 commits into
flutter:masterfrom
harryterkelsen:web-image-decode-with-createImageBitmap
May 7, 2026
Merged

feat(web): implement image decoding throttling for HTML images#186032
auto-submit[bot] merged 7 commits into
flutter:masterfrom
harryterkelsen:web-image-decode-with-createImageBitmap

Conversation

@harryterkelsen
Copy link
Copy Markdown
Contributor

Introduces a centralized ImageDecodingManager to coordinate the concurrency and memory footprint of HTMLImageElement.decode() calls. This prevents resource exhaustion and silent crashes on browsers like iOS Safari when handling high volumes of large image assets.

  • Added ImageDecodingManager to enforce safety limits (20 decodes / 128MB).
  • Refactored HtmlImageElementCodec to use a multi-phase throttled decode.
  • Implemented aggressive resource reclamation by clearing img.src on disposal.
  • Added unit tests for the manager and updated codec integration tests.

Largely alleviates #152709

Pre-launch Checklist

If you need help, consider asking for advice on the #hackers-new channel on Discord.

If this change needs to override an active code freeze, provide a comment explaining why. The code freeze workflow can be overridden by code reviewers. See pinned issues for any active code freezes with guidance.

Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

Introduces a centralized ImageDecodingManager to coordinate the concurrency
and memory footprint of HTMLImageElement.decode() calls. This prevents
resource exhaustion and silent crashes on browsers like iOS Safari when
handling high volumes of large image assets.

- Added ImageDecodingManager to enforce safety limits (20 decodes / 128MB).
- Refactored HtmlImageElementCodec to use a multi-phase throttled decode.
- Implemented aggressive resource reclamation by clearing img.src on disposal.
- Added unit tests for the manager and updated codec integration tests.
@flutter-dashboard flutter-dashboard Bot added the CICD Run CI/CD label May 5, 2026
@github-actions github-actions Bot added engine flutter/engine related. See also e: labels. platform-web Web applications specifically labels May 5, 2026
@harryterkelsen harryterkelsen requested a review from mdebbar May 5, 2026 00:02
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request introduces an ImageDecodingManager to throttle HTMLImageElement.decode() calls, addressing resource exhaustion and crashes on browsers like iOS Safari. The HtmlImageElementCodec is refactored into a multi-phase asynchronous process that manages concurrency and memory limits through a centralized FIFO queue. Feedback focuses on improving resource reclamation by clearing image sources during failures and enhancing error reporting by wrapping decoding operations in descriptive exceptions.

Comment thread engine/src/flutter/lib/web_ui/lib/src/engine/html_image_element_codec.dart Outdated
@github-actions github-actions Bot removed the CICD Run CI/CD label May 5, 2026
mdebbar
mdebbar previously approved these changes May 5, 2026
Comment thread engine/src/flutter/lib/web_ui/lib/src/engine/html_image_element_codec.dart Outdated
@github-actions github-actions Bot removed the CICD Run CI/CD label May 5, 2026
@harryterkelsen harryterkelsen added the CICD Run CI/CD label May 5, 2026
@github-actions github-actions Bot removed the CICD Run CI/CD label May 7, 2026
@harryterkelsen harryterkelsen added the CICD Run CI/CD label May 7, 2026
@harryterkelsen harryterkelsen added the autosubmit Merge PR when tree becomes green via auto submit App label May 7, 2026
@auto-submit auto-submit Bot added this pull request to the merge queue May 7, 2026
Merged via the queue into flutter:master with commit a05715c May 7, 2026
200 checks passed
@flutter-dashboard flutter-dashboard Bot removed the autosubmit Merge PR when tree becomes green via auto submit App label May 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CICD Run CI/CD engine flutter/engine related. See also e: labels. platform-web Web applications specifically

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants