Bug 1536224: Update Debugger documentation for async function initial yields. DONTBUILD r=jorendorff
authorJim Blandy <jimb@mozilla.com>
Wed, 20 Mar 2019 18:26:15 +0000
changeset 465260 72d6c8343c81237c8f416e1a7f477130ae5e177d
parent 465259 99aab1b8a0f78365904193e88a3927321431e1aa
child 465261 687da2cdbee54115e0a86fca32246402b37ac6d6
push id112496
push usershindli@mozilla.com
push dateThu, 21 Mar 2019 04:37:39 +0000
treeherdermozilla-inbound@29476d3ca61d [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewersjorendorff
bugs1536224, 1530324
milestone68.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
Bug 1536224: Update Debugger documentation for async function initial yields. DONTBUILD r=jorendorff Since bug 1530324 removed the wrapper functions for async functions, it is no longer true that a Debugger.Frame for an async function call calls its onPop handler once after evaluating default arguments but before beginning execution of the body. Differential Revision: https://phabricator.services.mozilla.com/D23939
js/src/doc/Debugger/Debugger.Frame.md
--- a/js/src/doc/Debugger/Debugger.Frame.md
+++ b/js/src/doc/Debugger/Debugger.Frame.md
@@ -148,25 +148,16 @@ 4.  The `frame.onPop` hook fires, with a
 
 In SpiderMonkey, this process of suspending and returning a new
 generator object is called the "initial yield".
 
 If the caller then uses the generator's `.next()` method, which may or
 may not happen right away depending on the debuggee code, the suspended
 generator will be resumed, firing `.onEnterFrame` again.
 
-**Stepping into async functions** — SpiderMonkey also performs an
-initial yield for async functions. This is not so easy to defend by
-citing the spec; we're just exposing internal SpiderMonkey
-implementation details. When the initial yield happens, you'll observe
-an extra `.onPop` returning a generator object that SpiderMonkey will
-use internally, followed immediately by a second `.onEnterFrame` event
-for the same frame.
-
-
 ## Accessor Properties of the Debugger.Frame Prototype Object
 
 A `Debugger.Frame` instance inherits the following accessor properties from
 its prototype:
 
 `type`
 :   A string describing what sort of frame this is: