Skip to content

ZoneSpecification and related types are underdocumented #44669

@Hixie

Description

@Hixie

I was trying to figure out how to catch all errors (sync and async) thrown while running a function. I figured out I probably want Zone.current.fork().runGuarded(), but when trying to figure out the arguments to fork I found that the following APIs are undocumented or underdocumented:

  • ZoneSpecification constructors don't explain their arguments
  • ZoneSpecification properties have no documentation
  • The typedefs used in those properties, such as CreatePeriodicTimerHandler, CreateTimerHandler, ErrorCallbackHandler, etc, have no documentation
  • The class itself doesn't say what the difference between errorCallback and handleUncaughtError is

See also #26455, #26454, #17667.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area-core-librarySDK core library issues (core, async, ...); use area-vm or area-web for platform specific libraries.library-coretype-documentationA request to add or improve documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions