Skip to content

avm2: Update comment about how FP handles uncaught errors - #24222

Open
kjarosh wants to merge 1 commit into
ruffle-rs:masterfrom
kjarosh:avm2-trace-uncaught-comment
Open

avm2: Update comment about how FP handles uncaught errors#24222
kjarosh wants to merge 1 commit into
ruffle-rs:masterfrom
kjarosh:avm2-trace-uncaught-comment

Conversation

@kjarosh

@kjarosh kjarosh commented Jul 15, 2026

Copy link
Copy Markdown
Member

Description

This adds more context to how uncaught exceptions work in FP.

Testing

N/A

Checklist

  • I, a human, have self-reviewed this PR and fully understand the changes within.
  • I have made or updated tests where possible.
  • All of my commits are properly scoped, compile successfully, and pass all tests.
  • This PR does not make sense to split up into smaller PRs.
  • An LLM was involved in the authoring of this code.

This adds more context to how uncaught exceptions work in FP.
@kjarosh
kjarosh requested a review from Lord-McSweeney July 15, 2026 19:26
@kjarosh kjarosh added A-avm2 Area: AVM2 (ActionScript 3) T-chore Type: Chore (like updating a dependency, it's gotta be done) labels Jul 15, 2026
Comment thread core/src/avm2.rs
// When tracing is disabled, the error won't get stringified for the
// second time (which is observable), so to improve compatibility in
// this regard, we disable this feature when emulating the release mode
// of FP.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can you mention that tracing and flashlog are the same thing?

Comment thread core/src/avm2.rs
// Flash Player traces uncaught errors (when tracing is enabled).
//
// When tracing is enabled, Flash Player will *always* log and stringify
// the exception twice.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can you move this comment after the comment explaining exception dialogs, to make it clearer that the exception dialog is the source of the first stringification?

Comment thread core/src/avm2.rs
// this regard, we disable this feature when emulating the release mode
// of FP.
//
// There is also the additional behavior of debugger exception dialogs,

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Could you make it clear that debugger exception dialogs also show up in non-debug FP? As it's written, this comment seems to suggest that they're specific to the debug player.

Comment thread core/src/avm2.rs
//
// There is also the additional behavior of debugger exception dialogs,
// and if they are enabled, Flash Player will pause the execution and
// show the uncaught exception in a popup. If the popups are disabled,

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Could you

  1. explain how to disable popups, using "dismiss all", and
  2. make it clear that this tracing only happens when flashlog is also enabled?

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

Labels

A-avm2 Area: AVM2 (ActionScript 3) T-chore Type: Chore (like updating a dependency, it's gotta be done)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants