Re: [whatwg/dom] Define a 'CancelationController' and 'CancelationSignal' interface. (#434)

domenic commented on this pull request.



> @@ -1419,6 +1423,114 @@ that gave folks all the wrong ideas. <a>Events</a> do not represent or cause act
 can only be used to influence an ongoing one.
 
 
+<h2 id=canceling-ongoing-activities>Canceling Ongoing Activities</h3>
+
+Though {{Promise}} objects don't have any built-in cancelation mechanism, many APIs using these
+concepts require cancelation semantics. {{CancelationController}} is meant to support these
+requirements by providing an {{CancelationController/cancel()}} method that toggles the state of a
+corresponding {{CancelationSignal}} object. The API which wishes to support cancelation can accept
+such a {{CancelationSignal}}, and use its state to determine how (not) to proceed.
+
+APIs that rely upon {{CancelationController}} are encouraged to respond to
+{{CancelationController/cancel()}} by rejecting any unsettled {{Promise}} with a new
+{{DOMException}} with [=error name=] "{{CancelationError}}".
+
+<div class=note>

`<div class=example id=...>` not `<div class=note>`

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/dom/pull/434#pullrequestreview-31881781