Update Polymer components and re-run reproduce.sh

third_party/polymer/v1_0/components-chromium/iron-ajax/iron-request-extracted.js

 
   Polymer({
     is: 'iron-request',
 
     properties: {
 
       /**
        * A reference to the XMLHttpRequest instance used to generate the
        * network request.
        *
        * @attribute xhr
        * @type XMLHttpRequest
        * @default `new XMLHttpRequest`
        */
       xhr: {
         type: Object,
         notify: true,
         readOnly: true,
         value: function() {
           return new XMLHttpRequest();
         }
       },
 
       /**
        * A reference to the parsed response body, if the `xhr` has completely
        * resolved.
        *
        * @attribute response
-       * @type Object
+       * @type {*}
        * @default null
        */
       response: {
         type: Object,
         notify: true,
         readOnly: true,
         value: function() {
          return null;
         }
       },
@@ skipping 49 matching lines @@
         value: false,
       }
     },
 
     /**
      * Succeeded is true if the request succeeded. The request succeeded if the
      * status code is greater-than-or-equal-to 200, and less-than 300. Also,
      * the status code 0 is accepted as a success even though the outcome may
      * be ambiguous.
      *
-     * @return boolean
+     * @return {boolean}
      */
     get succeeded() {
       var status = this.xhr.status || 0;
 
       // Note: if we are using the file:// protocol, the status code will be 0
       // for all outcomes (successful or otherwise).
       return status === 0 ||
         (status >= 200 && status < 300);
     },
 
     /**
      * Sends an HTTP request to the server and returns the XHR object.
      *
-     * @method request
      * @param {{
      *   url: string,
      *   method: (string|undefined),
      *   async: (boolean|undefined),
      *   body: (ArrayBuffer|ArrayBufferView|Blob|Document|FormData|null|string|undefined),
      *   headers: (Object|undefined),
      *   handleAs: (string|undefined),
      *   withCredentials: (boolean|undefined)}} options -
      *     url The url to which the request is sent.
      *     method The HTTP method to use, default is GET.
      *     async By default, all requests are sent asynchronously. To send synchronous requests,
      *         set to true.
      *     body The content for the request body for POST method.
      *     headers HTTP request headers.
      *     handleAs The response type. Default is 'text'.
      *     withCredentials Whether or not to send credentials on the request. Default is false.
-     * @return Promise
+     * @return {Promise}
      */
     send: function (options) {
       var xhr = this.xhr;
 
       if (xhr.readyState > 0) {
-        return;
+        return null;
       }
 
       xhr.addEventListener('readystatechange', function () {
         if (xhr.readyState === 4 && !this.aborted) {
 
           if (!this.succeeded) {
             this.rejectCompletes(new Error('The request failed with status code: ' + this.xhr.status));
             return;
           }
 
@@ skipping 36 matching lines @@
       // In IE, `xhr.responseType` is an empty string when the response
       // returns. Hence, caching it as `xhr._responseType`.
       xhr.responseType = xhr._responseType = (options.handleAs || 'text');
       xhr.withCredentials = !!options.withCredentials;
 
       xhr.send(options.body);
 
       return this.completes;
     },
 
+    /**
+     * Attempts to parse the response body of the XHR. If parsing succeeds,
+     * the value returned will be deserialized based on the `responseType`
+     * set on the XHR.
+     *
+     * @return {*} The parsed response,
+     * or undefined if there was an empty response or parsing failed.
+     */
     parseResponse: function () {
       var xhr = this.xhr;
       var responseType = this.xhr.responseType ||
         this.xhr._responseType;
       // If we don't have a natural `xhr.responseType`, we prefer parsing
       // `xhr.responseText` over returning `xhr.response`..
       var preferResponseText = !this.xhr.responseType;
 
       try {
         switch (responseType) {
@@ skipping 24 matching lines @@
             return xhr.response;
           case 'text':
           default:
             return xhr.responseText;
         }
       } catch (e) {
         this.rejectCompletes(new Error('Could not parse response. ' + e.message));
       }
     },
 
+    /**
+     * Aborts the request.
+     */
     abort: function () {
       this._setAborted(true);
       this.xhr.abort();
     }
   });