import HTTPResponse from './HTTPResponse'; import querystring from 'querystring'; import log from '../logger'; import { http, https } from 'follow-redirects'; import { parse } from 'url'; const clients = { 'http:': http, 'https:': https, }; function makeCallback(resolve, reject) { return function(response) { const chunks = []; response.on('data', chunk => { chunks.push(chunk); }); response.on('end', () => { const body = Buffer.concat(chunks); const httpResponse = new HTTPResponse(response, body); // Consider <200 && >= 400 as errors if (httpResponse.status < 200 || httpResponse.status >= 400) { return reject(httpResponse); } else { return resolve(httpResponse); } }); response.on('error', reject); }; } const encodeBody = function({ body, headers = {} }) { if (typeof body !== 'object') { return { body, headers }; } var contentTypeKeys = Object.keys(headers).filter(key => { return key.match(/content-type/i) != null; }); if (contentTypeKeys.length == 0) { // no content type // As per https://parse.com/docs/cloudcode/guide#cloud-code-advanced-sending-a-post-request the default encoding is supposedly x-www-form-urlencoded body = querystring.stringify(body); headers['Content-Type'] = 'application/x-www-form-urlencoded'; } else { /* istanbul ignore next */ if (contentTypeKeys.length > 1) { log.error( 'Parse.Cloud.httpRequest', 'multiple content-type headers are set.' ); } // There maybe many, we'll just take the 1st one var contentType = contentTypeKeys[0]; if (headers[contentType].match(/application\/json/i)) { body = JSON.stringify(body); } else if ( headers[contentType].match(/application\/x-www-form-urlencoded/i) ) { body = querystring.stringify(body); } } return { body, headers }; }; /** * Makes an HTTP Request. * * **Available in Cloud Code only.** * * By default, Parse.Cloud.httpRequest does not follow redirects caused by HTTP 3xx response codes. You can use the followRedirects option in the {@link Parse.Cloud.HTTPOptions} object to change this behavior. * * Sample request: * ``` * Parse.Cloud.httpRequest({ * url: 'http://www.parse.com/' * }).then(function(httpResponse) { * // success * console.log(httpResponse.text); * },function(httpResponse) { * // error * console.error('Request failed with response code ' + httpResponse.status); * }); * ``` * * @method httpRequest * @name Parse.Cloud.httpRequest * @param {Parse.Cloud.HTTPOptions} options The Parse.Cloud.HTTPOptions object that makes the request. * @return {Promise} A promise that will be resolved with a {@link Parse.Cloud.HTTPResponse} object when the request completes. */ module.exports = function httpRequest(options) { let url; try { url = parse(options.url); } catch (e) { return Promise.reject(e); } options = Object.assign(options, encodeBody(options)); // support params options if (typeof options.params === 'object') { options.qs = options.params; } else if (typeof options.params === 'string') { options.qs = querystring.parse(options.params); } const client = clients[url.protocol]; if (!client) { return Promise.reject(`Unsupported protocol ${url.protocol}`); } const requestOptions = { method: options.method, port: Number(url.port), path: url.pathname, hostname: url.hostname, headers: options.headers, encoding: null, followRedirects: options.followRedirects === true, }; if (requestOptions.headers) { Object.keys(requestOptions.headers).forEach(key => { if (typeof requestOptions.headers[key] === 'undefined') { delete requestOptions.headers[key]; } }); } if (url.search) { options.qs = Object.assign({}, options.qs, querystring.parse(url.query)); } if (url.auth) { requestOptions.auth = url.auth; } if (options.qs) { requestOptions.path += `?${querystring.stringify(options.qs)}`; } if (options.agent) { requestOptions.agent = options.agent; } return new Promise((resolve, reject) => { const req = client.request( requestOptions, makeCallback(resolve, reject, options) ); if (options.body) { req.write(options.body); } req.on('error', error => { reject(error); }); req.end(); }); }; /** * @typedef Parse.Cloud.HTTPOptions * @property {String|Object} body The body of the request. If it is a JSON object, then the Content-Type set in the headers must be application/x-www-form-urlencoded or application/json. You can also set this to a {@link Buffer} object to send raw bytes. If you use a Buffer, you should also set the Content-Type header explicitly to describe what these bytes represent. * @property {function} error The function that is called when the request fails. It will be passed a Parse.Cloud.HTTPResponse object. * @property {Boolean} followRedirects Whether to follow redirects caused by HTTP 3xx responses. Defaults to false. * @property {Object} headers The headers for the request. * @property {String} method The method of the request. GET, POST, PUT, DELETE, HEAD, and OPTIONS are supported. Will default to GET if not specified. * @property {String|Object} params The query portion of the url. You can pass a JSON object of key value pairs like params: {q : 'Sean Plott'} or a raw string like params:q=Sean Plott. * @property {function} success The function that is called when the request successfully completes. It will be passed a Parse.Cloud.HTTPResponse object. * @property {string} url The url to send the request to. */ module.exports.encodeBody = encodeBody;