[w3ctag/design-reviews] AbortSignal.timeout() (Issue #711)

Braw mornin' TAG!

I'm requesting a TAG review of `AbortSignal.timeout(milliseconds)`.

This introduces a new static method, `AbortSignal.timeout(milliseconds)`, which returns a newly-created `AbortSignal` that, after `milliseconds` milliseconds, becomes automatically aborted. The `AbortSignal`'s `reason` property will be a `"TimeoutError"` `DOMException`. The main motivating use case for this is helping web developers easily time out async operations, such as `fetch()`.

  - Explainer¹ (minimally containing user needs and example code): https://github.com/whatwg/dom/pull/1032#issue-1058779111

  - Specification URL: [spec url] DOM PR: https://github.com/whatwg/dom/pull/1032

  - Tests: [wpt folder(s), if available] To be added to https://github.com/web-platform-tests/wpt/tree/master/dom/abort

  - User research: None
  - Security and Privacy self-review²: https://gist.github.com/shaseley/2d3e76d98151811f1517f4380a12fe2b

  - GitHub repo (if you prefer feedback filed there): https://github.com/whatwg/dom/pull/1032

  - Primary contacts (and their relationship to the specification):
      - Domenic Denicola (@domenic, Google, specifier)
      - Scott Haseley (@shaseley, Google, Chromium implementer)
  - Organization(s)/project(s) driving the specification: WHATWG github issues (see below)
  - Key pieces of existing multi-stakeholder review or discussion of this specification:
     - Issue: https://github.com/whatwg/dom/issues/951

     - PR: https://github.com/whatwg/dom/pull/1032

     - Related issue, for `fetch()`: https://github.com/whatwg/fetch/issues/951

  - External status/issue trackers for this specification (publicly visible, e.g. Chrome Status):
     - https://chromestatus.com/feature/5768400507764736


Further details:

  - [X] I have reviewed the TAG's [Web Platform Design Principles](https://www.w3.org/TR/design-principles/)
  - Relevant time constraints or deadlines: No deadline, but the spec PR has been approved and has support from multiple implementers,  so I'd expect the first implementation and PR will both land soon.
  - The group where the work on this specification is currently being done: WHATWG
  - The group where standardization of this work is intended to be done (if current group is a community group or other incubation venue): N/A
  - Major unresolved issues with or opposition to this specification: None known
  - This work is being funded by: Google

We'd prefer the TAG provide feedback as (please delete all but the desired option):

  💬 leave review feedback as a **comment in this issue** and @-notify [@domenic, @shaseley ]


-- 
Reply to this email directly or view it on GitHub:
https://github.com/w3ctag/design-reviews/issues/711

You are receiving this because you are subscribed to this thread.

Message ID: <w3ctag/design-reviews/issues/711@github.com>