Add MerchantValidationEvent.prototype.methodName (#776)

Author: marcoscaceres

index.html

@@ -3819,10 +3819,21 @@ 
           [Constructor(DOMString type, optional MerchantValidationEventInit eventInitDict),
           SecureContext, Exposed=Window]
           interface MerchantValidationEvent : Event {
+            readonly attribute DOMString methodName;
             readonly attribute USVString validationURL;
             void complete(Promise<any> merchantSessionPromise);
           };
         pre>
+        <section>
+          <h2>
+            <dfn>methodNamedfn> attribute
+          h2>
+          <p data-link-for="MerchantValidationEventInit">
+            When getting, returns the value it was initialized with. See
+            <a>methodNamea> member of <a>MerchantValidationEventInita> for
+            more information.
+          p>
+        section>
         <section>
           <h3>
             <dfn data-lt=
@@ -3842,14 +3853,10 @@ 
             settings objecta>’s <a data-cite=
             "!html/multipage/webappapis.html#api-base-url">API base URLa>.
             li>
-            <li>Let <var>inputvar> be the empty string.
-            li>
-            <li>If <var>eventInitDictvar> was passed, set <var>inputvar> to
-            the value of <var>eventInitDictvar>["<a>validationURLa>"].
-            li>
             <li data-link-for="MerchantValidationEventInit">Let
             <var>validationURLvar> be the result of <a data-cite=
-            "!url#concept-url-parser">URL parsinga> <var>inputvar> and
+            "!url#concept-url-parser">URL parsinga>
+            <var>eventInitDictvar>["<a>validationURLa>"] and
             <var>basevar>.
             li>
             <li>If <var>validationURLvar> is failure, throw a
@@ -3858,6 +3865,17 @@ 
             <li>Initialize <var>eventvar>.<a>validationURLa> attribute to
             <var>validationURLvar>.
             li>
+            <li>If <var>eventInitDictvar>["<a>methodNamea>"] is not the
+            empty string, run the steps to <a data-cite=
+            "payment-method-id#dfn-validate-a-payment-method-identifier">validate
+            a payment method identifiera> with
+            <var>eventInitDictvar>["<a>methodNamea>"]. If it returns false,
+            then throw a <a>RangeErrora> exception. Optionally, inform the
+            developer that the payment method identifier is invalid.
+            li>
+            <li>Initialize <var>eventvar>.<a>methodNamea> attribute to
+            <var>eventInitDictvar>["<a>methodNamea>"].
+            li>
             <li>Initialize <var>eventvar>.<a data-lt=
             "mechvalidation.waitForUpdate">[[\waitForUpdate]]a> to false.
             li>
@@ -3956,18 +3974,26 @@ 
           h3>
           <pre class="idl">
             dictionary MerchantValidationEventInit : EventInit {
+              DOMString methodName = "";
               USVString validationURL = "";
             };
           pre>
-          <section>
-            <h4>
+          <dl>
+            <dt>
+              <dfn>methodNamedfn> member
+            dt>
+            <dd>
+              A <a>payment method identifiera> representing the <a>payment
+              handlera> that is requiring <a>merchant validationa>.
+            dd>
+            <dt>
               <dfn>validationURLdfn> member
-            h4>
-            <p>
+            dt>
+            <dd>
               A URL from which a developer would fetch <a>payment
               handlera>-specific verification data.
-            p>
-          section>
+            dd>
+          dl>
         section>
       section>
       <section data-dfn-for="PaymentMethodChangeEvent" data-link-for=
@@ -4018,7 +4044,7 @@ 
               <dfn>methodNamedfn> member
             dt>
             <dd>
-              A DOMString representing the <a>payment method identifiera>.
+              A string representing the <a>payment method identifiera>.
             dd>
             <dt>
               <dfn>methodDetailsdfn> member
@@ -4253,10 +4279,14 @@ 
           developer can fetch <a>payment handlera>-specific verification
           data.
           li>
+          <li>Let <var>methodNamevar> be the <a>payment method identifiera>
+          for the <a>payment handlera> that is requiring <a>merchant
+          validationa>.
+          li>
           <li>
             <a>Queue a taska> on the <a>user interaction task sourcea> to
             run the following steps:
-            <ol>
+            <ol data-link-for="MerchantValidationEventInit">
               <li>Assert: <var>requestvar>.<a>[[\updating]]a> is false.
               li>
               <li>Assert: <var>requestvar>.<a>[[\state]]a> is
@@ -4265,9 +4295,11 @@ 
               <li>Let <var>eventInitDictvar> be an new
               <a>MerchantValidationEventInita> dictionary.
               li>
-              <li data-link-for="MerchantValidationEventInit">Set
-              <var>eventInitDictvar>["<a>validationURLa>"] to
-              <var>validationURLvar>.
+              <li>Set <var>eventInitDictvar>["<a>validationURLa>"] to <var>
+                validationURLvar>.
+              li>
+              <li>Set <var>eventInitDictvar>["<a>methodNamea>"] to
+              <var>methodNamevar>.
               li>
               <li>Let <var>eventvar> be the result of <a data-cite=
               "dom#concept-event-constructor">constructinga> a