904716 - Updates needed for debugger docs

Status: RESOLVED FIXED

(DevTools :: Debugger, task, P5)

Description

[Brandon Benvie [:benvie]]

I just did an inventory comparing what's actually implemented to what DebuggerDocs claims. There's a handful of undocumented things, a number of things that are unimplemented but not noted as so, and one discrepancy. We should try to keep the docs as close as possible to the implementation.

Debugger
undocumented
* removeAllDebuggees
* addAllGlobalsAsDebuggees
unimplemented
* onThrow
* onError
* findScriptURLs
* clearBreakpoint
* clearAllWatchpoints


Debugger.Frame
unimplemented
* onResume
* get depth
* pop
* replaceCall


Debugger.Script
undocumented
* get source
* get sourceStart
* get sourceLength
unimplemented
* get strictMode
* decompile
discrepencies
* clearBreakpoint <-> clearBreakpoints


Debugger.Object
unimplemented
* get proxyHandler
* get proxyCallTrap
* get proxyConstructTrap
* get hostAnnotations
* getProperty
* setProperty
* copy
* create
* decompile
* asEnvironment
* setObjectWatchpoint
* clearObjectWatchpoint
* setPropertyWatchPoint
* clearPropertyWatchpoint

Comment 1

[Jim Blandy :jimb]

Wow, thanks for the audit! This is really helpful.

I can't get to this today. :( But I will go after it as soon as I can.

Comment 2

[Wladimir Palant]

Unfortunately, the docs are still claiming support for features that weren't implemented - I wasted quite a bit of time on this. It would already help if the docs in MDN reflected the latest state of the documentation in the source code.

Comment 3

[Logan Smyth [:loganfsmyth]]

I'm not aware of any remaining documented but non-existant methods, so going to close.