[Issue] Asdoc bug treats "/" within RegExp literals incorrectly as a RegExp delimiter

[shaucky]

Problem Description

AIR SDK version: 51.0.1.1

When generating document using asdoc, the forward slash character / within RegExp literals is mistakenly treated as the delimiter for the RegExp, which leads to a compilation failure.

Steps to Reproduce

Code Example:

public static const MAILBOX:RegExp = /^(([\w!#$%&'*+-/=?^_`{|}~]+(\.[\w!#$%&'*+-/=?^_`{|}~]+)*)|("[\x20-\x21\x23-\x5B\x5D-\x7E\x5C\x20-\x7E]*"))@((([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9]?\.)*[A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9]?)|\[([0-9]{1,3}\.){3}[0-9]{1,3}\])$/;

(This example is because the bug found when I'm developing a email client library…)

Known Workarounds

Escape the slash / with a backslash \ in RegExp literals, although this should not be necessary according to standards.

[ajwfrost]

I would say this works as expected... the specification here is ECMA-262, 3rd Ed, so if you look at section 7.8.5 you get the grammar for a regular expression literal:

Syntax

RegularExpressionLiteral ::
/ RegularExpressionBody / RegularExpressionFlags

RegularExpressionBody ::
RegularExpressionFirstChar RegularExpressionChars

RegularExpressionChars ::
[empty]
RegularExpressionChars RegularExpressionChar

RegularExpressionFirstChar ::
NonTerminator but not * or \ or /
BackslashSequence

RegularExpressionChar ::
NonTerminator but not \ or /
BackslashSequence

BackslashSequence ::
\ NonTerminator

NonTerminator ::
SourceCharacter but not LineTerminator

So not * or / or \ would imply you can't use a forward-slash, unless it's part of a BackslashSequence...

https://www.ecma-international.org/wp-content/uploads/ECMA-262_3rd_edition_december_1999.pdf

[shaucky]

I see…

But there's a matter that there is a behavioral inconsistency between the ActionScript 3 compiler and asdoc here. Shouldn't asdoc as an annotation tool, prioritize the language itself?

Thanks.

[ajwfrost]

Ah, I may have misunderstood what you were originally reporting then... I wasn't referring to asdoc, just looking at the regular expression / ActionScript code that you posted.

And oddly, that RegExp compiles fine (well, in terms of the AS3 compiler) when I try that..? Will need to check what should happen here from the compiler perspective as well as from the asdoc side..