Skip to content

Document Wasm exception handling#44025

Draft
chrisdavidmills wants to merge 1 commit intomdn:mainfrom
chrisdavidmills:wasm-exception-handling
Draft

Document Wasm exception handling#44025
chrisdavidmills wants to merge 1 commit intomdn:mainfrom
chrisdavidmills:wasm-exception-handling

Conversation

@chrisdavidmills
Copy link
Copy Markdown
Contributor

@chrisdavidmills chrisdavidmills commented May 6, 2026

Description

This PR adds documentation for "modern" WebAssembly Exception handling. I am not intending to document "legacy" Wasm exception handling alongside this, as it would make the documentation significantly more complex (some features are used in both), and I'm sure we want to encourage devs to use the modern version.

Specifically, this PR documents the following:

  • tag definition
  • exnref type
  • throw instruction
  • throw_ref instruction
  • try_table instruction
  • catch instruction
  • catch_all instruction
  • catch_ref instruction
  • catch_ref_all instruction

I am also going to check whether the following, already existing, ref docs need any updates:

  • WebAssembly.Tag and members
  • WebAssembly.Exception and members

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner May 6, 2026 15:13
@chrisdavidmills chrisdavidmills requested review from hamishwillee and removed request for a team May 6, 2026 15:13
@chrisdavidmills chrisdavidmills marked this pull request as draft May 6, 2026 15:13
@github-actions github-actions Bot added Content:wasm WebAssembly docs size/m [PR only] 51-500 LoC changed labels May 6, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 6, 2026

Preview URLs (1 page)

Flaws (12)

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/WebAssembly/Reference/Definitions/tag
Title: tag: Wasm definition
Flaw count: 12

  • broken_links:
    • Link /en-US/docs/WebAssembly/Reference/Types/exnref doesn't resolve
    • Link /en-US/docs/WebAssembly/Reference/Exception_handling/try_table doesn't resolve
    • Link /en-US/docs/WebAssembly/Reference/Exception_handling/catch doesn't resolve
    • Link /en-US/docs/WebAssembly/Reference/Exception_handling/catch_all doesn't resolve
    • Link /en-US/docs/WebAssembly/Reference/Exception_handling/catch_ref doesn't resolve
    • and 7 more flaws omitted

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

Labels

Content:wasm WebAssembly docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants