Allow enctype to be specified (#54)

* Allow enctype to be specified

POST supports "application/x-www-form-urlencoded" and
"multipart/form-data".

resolves #47

* enctype ignored for GET

Author: ewilligers

index.html

@@ -200,6 +200,7 @@ <h2>
 dictionary ShareTarget {
   required USVString action;
   DOMString method = "GET";
+  DOMString enctype = "application/x-www-form-urlencoded";
   required ShareTargetParams params;
 };
 
@@ -260,6 +261,19 @@ <h3>
             developer warning</a> that the method is not supported, and return
             <code>undefined</code>.
           </li>
+          <li>If <var>share target</var>["<a data-link-for=
+          "ShareTarget">method</a>"] is an <a data-cite=
+          "!INFRA#ascii-case-insensitive">ASCII case-insensitive</a> match for
+          the string <code>"POST"</code> and <var>share
+          target</var>["<a data-link-for="ShareTarget">enctype</a>"] is neither
+          an <a data-cite="!INFRA#ascii-case-insensitive">ASCII
+          case-insensitive</a> match for the strings
+          <code>"application/x-www-form-urlencoded"</code> nor
+          <code>"multipart/form-data"</code>, <a data-cite=
+          "!appmanifest#dfn-issue-a-developer-warning">issue a developer
+          warning</a> that the enctype is not supported, and return
+          <code>undefined</code>.
+          </li>
           <li>Let <var>action</var> be the result of <a data-cite=
           "!URL#concept-url-parser">parsing</a> the <a data-cite=
           "!URL#concept-url">URL</a> <var>share
@@ -301,6 +315,11 @@ <h3>
           "https://tools.ietf.org/html/rfc7231#section-4">method</a> for the
           <a data-link-for="web share targets">web share target</a>.
         </p>
+        <p>
+          The <dfn>enctype</dfn> member specifies how the share data is encoded
+          in the body of a <code>POST</code> request. It is ignored when
+          <a>method</a> is <code>"GET"</code>.
+        </p>
         <p>
           The <dfn>params</dfn> member contains a <a>ShareTargetParams</a>
           dictionary.
@@ -489,6 +508,10 @@ <h3>
           <var>manifest</var>["<a>share_target</a>"]["<a data-link-for=
           "ShareTarget">method</a>"].
           </li>
+          <li>Let <var>enctype</var> be
+          <var>manifest</var>["<a>share_target</a>"]["<a data-link-for=
+          "ShareTarget">enctype</a>"].
+          </li>
           <li>If <var>method</var> is <code>"GET"</code>:
             <ol>
               <li>Let <var>query</var> be the result of running the
@@ -504,7 +527,26 @@ <h3>
               </li>
             </ol>
           </li>
-          <li>Otherwise, if <var>method</var> is <code>"POST"</code>:
+          <li>Otherwise, if <var>method</var> is <code>"POST"</code> and <var>
+            enctype</var> is <code>"application/x-www-form-urlencoded"</code>:
+            <ol>
+              <li>Let <var>body</var> be the result of running the
+                <a data-cite="!URL#concept-urlencoded-serializer"><code>application/x-www-form-urlencoded</code>
+                serializer</a> with <var>entry list</var> and no encoding
+                override.
+              </li>
+              <li>Set <var>body</var> to the result of <a data-cite=
+              "!Encoding#utf-8-encode">encoding</a> <var>body</var>.
+              </li>
+              <li>
+                <a data-cite="!FETCH/#concept-header-list-append">Append</a>
+                <code>"Content-Type"</code>/<code>"application/x-www-form-urlencoded"</code>
+                to <var>header list</var>.
+              </li>
+            </ol>
+          </li>
+          <li>Otherwise, if <var>method</var> is <code>"POST"</code> and <var>
+            enctype</var> is <code>"multipart/form-data"</code>:
             <ol>
               <li>Let <var>body</var> be the result of running the
                 <a data-cite="!HTML#multipart/form-data-encoding-algorithm"><code>
@@ -522,7 +564,7 @@ <h3>
               </li>
               <li>
                 <a data-cite="!FETCH/#concept-header-list-append">Append</a>
-                <code>Content-Type</code>/<var>MIME type</var> to <var>header
+                <code>"Content-Type"</code>/<var>MIME type</var> to <var>header
                 list</var>.
               </li>
             </ol>