retry() interacting with abort the update (#723)

Author: marcoscaceres

index.html

@@ -3239,10 +3239,10 @@ 
           li>
           <li>Return <var>retryPromisevar>.
             <p class="note">
-              The <var>retryPromisevar> will later be resolved or rejected by
-              either the <a>user accepts the payment request algorithma> or
-              the <a>user aborts the payment request algorithma>, which are
-              triggered through interaction with the user interface.
+              The <var>retryPromisevar> will later be resolved by the <a>user
+              accepts the payment request algorithma>, or rejected by either
+              the <a>user aborts the payment request algorithma> or <a>abort
+              the updatea>.
             p>
           li>
         ol>
@@ -3546,7 +3546,8 @@ 
             td>
             <td data-link-for="PaymentResponse">
               Is true if the request for payment has completed (i.e.,
-              <a>complete()a> was called), or false otherwise.
+              <a>complete()a> was called, or there was a fatal error that
+              made the response not longer usable), or false otherwise.
             td>
           tr>
           <tr>
@@ -4218,10 +4219,15 @@ 
           <li>Let <var>responsevar> be
           <var>requestvar>.<a>[[\response]]a>.
           li>
-          <li>If <var>responsevar> not null:
+          <li>If <var>responsevar> is not null:
             <ol>
+              <li>Set <var>responsevar>.<a>[[\complete]]a> to true.
+              li>
+              <li>Assert: <var>responsevar>.<a>[[\retryPromise]]a> is not
+              null.
+              li>
               <li>Reject <var>responsevar>.<a>[[\retryPromise]]a> with
-              <var>errorvar>
+              <var>errorvar>.
               li>
             ol>
           li>
@@ -4546,7 +4552,22 @@ 
                 <li>Set <var>requestvar>.<a>[[\state]]a> to
                 "<a>closeda>".
                 li>
-                <li>Reject the promise
+                <li>Let <var>responsevar> be
+                <var>requestvar>.<a>[[\response]]a>.
+                li>
+                <li>If <var>responsevar> is not null, then:
+                  <ol>
+                    <li>Set <var>responsevar>.<a>[[\complete]]a> to true.
+                    li>
+                    <li>Assert: <var>responsevar>.<a>[[\retryPromise]]a> is
+                    not null.
+                    li>
+                    <li>Reject <var>responsevar>.<a>[[\retryPromise]]a>
+                    with <var>exceptionvar>.
+                    li>
+                  ol>
+                li>
+                <li>Otherwise, reject
                 <var>requestvar>.<a>[[\acceptPromise]]a> with
                 <var>exceptionvar>.
                 li>
@@ -4560,17 +4581,25 @@ 
         section>
         <div class="note">
           <p>
-            <a data-lt="abort the update">Aborting the updatea> is performed
-            when there is a fatal error updating the payment request, such as
-            the supplied <var>detailsPromisevar> rejecting, or its
-            fulfillment value containing invalid data. This would potentially
-            leave the payment request in an inconsistent state since the
-            developer hasn't successfully handled the change event.
+            <a>Abort the updatea> runs when there is a fatal error updating
+            the payment request, such as the supplied <var>detailsPromisevar>
+            rejecting, or its fulfillment value containing invalid data. This
+            would potentially leave the payment request in an inconsistent
+            state since the developer hasn't successfully handled the change
+            event.
+          p>
+          <p>
             Consequently, the <a>PaymentRequesta> moves to a "<a>closeda>"
             state. The error is signaled to the developer through the rejection
             of the <a>[[\acceptPromise]]a>, i.e., the promise returned by
             <a data-lt="PaymentRequest.show">show()a>.
           p>
+          <p data-link-for="PaymentResponse">
+            Similarly, <a>abort the updatea> occurring during <a>retry()a>
+            causes the <a>[[\retryPromise]]a> to reject, and the
+            corresponding <a>PaymentRequesta>'s <a>[[\complete]]a> internal
+            slot will be set to true (i.e., it can no longer be used).
+          p>
         div>
       section>
     section>