axios 1.0.0-alpha.1 → 1.1.0

package/lib/utils.js

@@ -1,76 +1,73 @@
 'use strict';
 
-var bind = require('./helpers/bind');
+import bind from './helpers/bind.js';
 
 // utils is a library of generic helper functions non-specific to axios
 
-var toString = Object.prototype.toString;
+const {toString} = Object.prototype;
+const {getPrototypeOf} = Object;
 
-// eslint-disable-next-line func-names
-var kindOf = (function(cache) {
-  // eslint-disable-next-line func-names
-  return function(thing) {
-    var str = toString.call(thing);
+const kindOf = (cache => thing => {
+    const str = toString.call(thing);
     return cache[str] || (cache[str] = str.slice(8, -1).toLowerCase());
-  };
 })(Object.create(null));
 
-function kindOfTest(type) {
+const kindOfTest = (type) => {
   type = type.toLowerCase();
-  return function isKindOf(thing) {
-    return kindOf(thing) === type;
-  };
+  return (thing) => kindOf(thing) === type
 }
 
+const typeOfTest = type => thing => typeof thing === type;
+
 /**
  * Determine if a value is an Array
  *
  * @param {Object} val The value to test
+ *
  * @returns {boolean} True if value is an Array, otherwise false
  */
-function isArray(val) {
-  return Array.isArray(val);
-}
+const {isArray} = Array;
 
 /**
  * Determine if a value is undefined
  *
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if the value is undefined, otherwise false
  */
-function isUndefined(val) {
-  return typeof val === 'undefined';
-}
+const isUndefined = typeOfTest('undefined');
 
 /**
  * Determine if a value is a Buffer
  *
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a Buffer, otherwise false
  */
 function isBuffer(val) {
   return val !== null && !isUndefined(val) && val.constructor !== null && !isUndefined(val.constructor)
-    && typeof val.constructor.isBuffer === 'function' && val.constructor.isBuffer(val);
+    && isFunction(val.constructor.isBuffer) && val.constructor.isBuffer(val);
 }
 
 /**
  * Determine if a value is an ArrayBuffer
  *
- * @function
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is an ArrayBuffer, otherwise false
  */
-var isArrayBuffer = kindOfTest('ArrayBuffer');
+const isArrayBuffer = kindOfTest('ArrayBuffer');
 
 
 /**
  * Determine if a value is a view on an ArrayBuffer
  *
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a view on an ArrayBuffer, otherwise false
  */
 function isArrayBufferView(val) {
-  var result;
+  let result;
   if ((typeof ArrayBuffer !== 'undefined') && (ArrayBuffer.isView)) {
     result = ArrayBuffer.isView(val);
   } else {
@@ -82,112 +79,116 @@ function isArrayBufferView(val) {
 /**
  * Determine if a value is a String
  *
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a String, otherwise false
  */
-function isString(val) {
-  return typeof val === 'string';
-}
+const isString = typeOfTest('string');
+
+/**
+ * Determine if a value is a Function
+ *
+ * @param {*} val The value to test
+ * @returns {boolean} True if value is a Function, otherwise false
+ */
+const isFunction = typeOfTest('function');
 
 /**
  * Determine if a value is a Number
  *
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a Number, otherwise false
  */
-function isNumber(val) {
-  return typeof val === 'number';
-}
+const isNumber = typeOfTest('number');
 
 /**
  * Determine if a value is an Object
  *
- * @param {Object} val The value to test
+ * @param {*} thing The value to test
+ *
  * @returns {boolean} True if value is an Object, otherwise false
  */
-function isObject(val) {
-  return val !== null && typeof val === 'object';
-}
+const isObject = (thing) => thing !== null && typeof thing === 'object';
+
+/**
+ * Determine if a value is a Boolean
+ *
+ * @param {*} thing The value to test
+ * @returns {boolean} True if value is a Boolean, otherwise false
+ */
+const isBoolean = thing => thing === true || thing === false;
 
 /**
  * Determine if a value is a plain Object
  *
- * @param {Object} val The value to test
- * @return {boolean} True if value is a plain Object, otherwise false
+ * @param {*} val The value to test
+ *
+ * @returns {boolean} True if value is a plain Object, otherwise false
  */
-function isPlainObject(val) {
+const isPlainObject = (val) => {
   if (kindOf(val) !== 'object') {
     return false;
   }
 
-  var prototype = Object.getPrototypeOf(val);
-  return prototype === null || prototype === Object.prototype;
+  const prototype = getPrototypeOf(val);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in val) && !(Symbol.iterator in val);
 }
 
 /**
  * Determine if a value is a Date
  *
- * @function
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a Date, otherwise false
  */
-var isDate = kindOfTest('Date');
+const isDate = kindOfTest('Date');
 
 /**
  * Determine if a value is a File
  *
- * @function
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a File, otherwise false
  */
-var isFile = kindOfTest('File');
+const isFile = kindOfTest('File');
 
 /**
  * Determine if a value is a Blob
  *
- * @function
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a Blob, otherwise false
  */
-var isBlob = kindOfTest('Blob');
+const isBlob = kindOfTest('Blob');
 
 /**
  * Determine if a value is a FileList
  *
- * @function
- * @param {Object} val The value to test
- * @returns {boolean} True if value is a File, otherwise false
- */
-var isFileList = kindOfTest('FileList');
-
-/**
- * Determine if a value is a Function
+ * @param {*} val The value to test
  *
- * @param {Object} val The value to test
- * @returns {boolean} True if value is a Function, otherwise false
+ * @returns {boolean} True if value is a File, otherwise false
  */
-function isFunction(val) {
-  return toString.call(val) === '[object Function]';
-}
+const isFileList = kindOfTest('FileList');
 
 /**
  * Determine if a value is a Stream
  *
- * @param {Object} val The value to test
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a Stream, otherwise false
  */
-function isStream(val) {
-  return isObject(val) && isFunction(val.pipe);
-}
+const isStream = (val) => isObject(val) && isFunction(val.pipe);
 
 /**
  * Determine if a value is a FormData
  *
- * @param {Object} thing The value to test
+ * @param {*} thing The value to test
+ *
  * @returns {boolean} True if value is an FormData, otherwise false
  */
-function isFormData(thing) {
-  var pattern = '[object FormData]';
+const isFormData = (thing) => {
+  const pattern = '[object FormData]';
   return thing && (
     (typeof FormData === 'function' && thing instanceof FormData) ||
     toString.call(thing) === pattern ||
@@ -197,49 +198,22 @@ function isFormData(thing) {
 
 /**
  * Determine if a value is a URLSearchParams object
- * @function
- * @param {Object} val The value to test
+ *
+ * @param {*} val The value to test
+ *
  * @returns {boolean} True if value is a URLSearchParams object, otherwise false
  */
-var isURLSearchParams = kindOfTest('URLSearchParams');
+const isURLSearchParams = kindOfTest('URLSearchParams');
 
 /**
  * Trim excess whitespace off the beginning and end of a string
  *
  * @param {String} str The String to trim
- * @returns {String} The String freed of excess whitespace
- */
-function trim(str) {
-  return str.trim ? str.trim() : str.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, '');
-}
-
-/**
- * Determine if we're running in a standard browser environment
- *
- * This allows axios to run in a web worker, and react-native.
- * Both environments support XMLHttpRequest, but not fully standard globals.
  *
- * web workers:
- *  typeof window -> undefined
- *  typeof document -> undefined
- *
- * react-native:
- *  navigator.product -> 'ReactNative'
- * nativescript
- *  navigator.product -> 'NativeScript' or 'NS'
+ * @returns {String} The String freed of excess whitespace
  */
-function isStandardBrowserEnv() {
-  var product;
-  if (typeof navigator !== 'undefined' && (
-    (product = navigator.product) === 'ReactNative' ||
-    product === 'NativeScript' ||
-    product === 'NS')
-  ) {
-    return false;
-  }
-
-  return typeof window !== 'undefined' && typeof document !== 'undefined';
-}
+const trim = (str) => str.trim ?
+  str.trim() : str.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, '');
 
 /**
  * Iterate over an Array or an Object invoking a function for each item.
@@ -252,13 +226,19 @@ function isStandardBrowserEnv() {
  *
  * @param {Object|Array} obj The object to iterate
  * @param {Function} fn The callback to invoke for each item
+ *
+ * @param {Boolean} [allOwnKeys = false]
+ * @returns {void}
  */
-function forEach(obj, fn) {
+function forEach(obj, fn, {allOwnKeys = false} = {}) {
   // Don't bother if no value provided
   if (obj === null || typeof obj === 'undefined') {
     return;
   }
 
+  let i;
+  let l;
+
   // Force an array if not already something iterable
   if (typeof obj !== 'object') {
     /*eslint no-param-reassign:0*/
@@ -267,15 +247,18 @@ function forEach(obj, fn) {
 
   if (isArray(obj)) {
     // Iterate over array values
-    for (var i = 0, l = obj.length; i < l; i++) {
+    for (i = 0, l = obj.length; i < l; i++) {
       fn.call(null, obj[i], i, obj);
     }
   } else {
     // Iterate over object keys
-    for (var key in obj) {
-      if (Object.prototype.hasOwnProperty.call(obj, key)) {
-        fn.call(null, obj[key], key, obj);
-      }
+    const keys = allOwnKeys ? Object.getOwnPropertyNames(obj) : Object.keys(obj);
+    const len = keys.length;
+    let key;
+
+    for (i = 0; i < len; i++) {
+      key = keys[i];
+      fn.call(null, obj[key], key, obj);
     }
   }
 }
@@ -295,11 +278,12 @@ function forEach(obj, fn) {
  * ```
  *
  * @param {Object} obj1 Object to merge
+ *
  * @returns {Object} Result of all merge properties
  */
 function merge(/* obj1, obj2, obj3, ... */) {
-  var result = {};
-  function assignValue(val, key) {
+  const result = {};
+  const assignValue = (val, key) => {
     if (isPlainObject(result[key]) && isPlainObject(val)) {
       result[key] = merge(result[key], val);
     } else if (isPlainObject(val)) {
@@ -311,8 +295,8 @@ function merge(/* obj1, obj2, obj3, ... */) {
     }
   }
 
-  for (var i = 0, l = arguments.length; i < l; i++) {
-    forEach(arguments[i], assignValue);
+  for (let i = 0, l = arguments.length; i < l; i++) {
+    arguments[i] && forEach(arguments[i], assignValue);
   }
   return result;
 }
@@ -323,16 +307,18 @@ function merge(/* obj1, obj2, obj3, ... */) {
  * @param {Object} a The object to be extended
  * @param {Object} b The object to copy properties from
  * @param {Object} thisArg The object to bind function to
- * @return {Object} The resulting value of object a
+ *
+ * @param {Boolean} [allOwnKeys]
+ * @returns {Object} The resulting value of object a
  */
-function extend(a, b, thisArg) {
-  forEach(b, function assignValue(val, key) {
-    if (thisArg && typeof val === 'function') {
+const extend = (a, b, thisArg, {allOwnKeys}= {}) => {
+  forEach(b, (val, key) => {
+    if (thisArg && isFunction(val)) {
       a[key] = bind(val, thisArg);
     } else {
       a[key] = val;
     }
-  });
+  }, {allOwnKeys});
   return a;
 }
 
@@ -340,9 +326,10 @@ function extend(a, b, thisArg) {
  * Remove byte order marker. This catches EF BB BF (the UTF-8 BOM)
  *
  * @param {string} content with BOM
- * @return {string} content value without BOM
+ *
+ * @returns {string} content value without BOM
  */
-function stripBOM(content) {
+const stripBOM = (content) => {
   if (content.charCodeAt(0) === 0xFEFF) {
     content = content.slice(1);
   }
@@ -355,11 +342,15 @@ function stripBOM(content) {
  * @param {function} superConstructor
  * @param {object} [props]
  * @param {object} [descriptors]
+ *
+ * @returns {void}
  */
-
-function inherits(constructor, superConstructor, props, descriptors) {
+const inherits = (constructor, superConstructor, props, descriptors) => {
   constructor.prototype = Object.create(superConstructor.prototype, descriptors);
   constructor.prototype.constructor = constructor;
+  Object.defineProperty(constructor, 'super', {
+    value: superConstructor.prototype
+  });
   props && Object.assign(constructor.prototype, props);
 }
 
@@ -369,14 +360,14 @@ function inherits(constructor, superConstructor, props, descriptors) {
  * @param {Object} [destObj]
  * @param {Function|Boolean} [filter]
  * @param {Function} [propFilter]
+ *
  * @returns {Object}
  */
-
-function toFlatObject(sourceObj, destObj, filter, propFilter) {
-  var props;
-  var i;
-  var prop;
-  var merged = {};
+const toFlatObject = (sourceObj, destObj, filter, propFilter) => {
+  let props;
+  let i;
+  let prop;
+  const merged = {};
 
   destObj = destObj || {};
   // eslint-disable-next-line no-eq-null,eqeqeq
@@ -392,71 +383,99 @@ function toFlatObject(sourceObj, destObj, filter, propFilter) {
         merged[prop] = true;
       }
     }
-    sourceObj = filter !== false && Object.getPrototypeOf(sourceObj);
+    sourceObj = filter !== false && getPrototypeOf(sourceObj);
   } while (sourceObj && (!filter || filter(sourceObj, destObj)) && sourceObj !== Object.prototype);
 
   return destObj;
 }
 
-/*
- * determines whether a string ends with the characters of a specified string
+/**
+ * Determines whether a string ends with the characters of a specified string
+ *
  * @param {String} str
  * @param {String} searchString
  * @param {Number} [position= 0]
+ *
  * @returns {boolean}
  */
-function endsWith(str, searchString, position) {
+const endsWith = (str, searchString, position) => {
   str = String(str);
   if (position === undefined || position > str.length) {
     position = str.length;
   }
   position -= searchString.length;
-  var lastIndex = str.indexOf(searchString, position);
+  const lastIndex = str.indexOf(searchString, position);
   return lastIndex !== -1 && lastIndex === position;
 }
 
 
 /**
  * Returns new array from array like object or null if failed
+ *
  * @param {*} [thing]
+ *
  * @returns {?Array}
  */
-function toArray(thing) {
+const toArray = (thing) => {
   if (!thing) return null;
   if (isArray(thing)) return thing;
-  var i = thing.length;
+  let i = thing.length;
   if (!isNumber(i)) return null;
-  var arr = new Array(i);
+  const arr = new Array(i);
   while (i-- > 0) {
     arr[i] = thing[i];
   }
   return arr;
 }
 
+/**
+ * Checking if the Uint8Array exists and if it does, it returns a function that checks if the
+ * thing passed in is an instance of Uint8Array
+ *
+ * @param {TypedArray}
+ *
+ * @returns {Array}
+ */
 // eslint-disable-next-line func-names
-var isTypedArray = (function(TypedArray) {
+const isTypedArray = (TypedArray => {
   // eslint-disable-next-line func-names
-  return function(thing) {
+  return thing => {
     return TypedArray && thing instanceof TypedArray;
   };
-})(typeof Uint8Array !== 'undefined' && Object.getPrototypeOf(Uint8Array));
+})(typeof Uint8Array !== 'undefined' && getPrototypeOf(Uint8Array));
 
-function forEachEntry(obj, fn) {
-  var generator = obj && obj[Symbol.iterator];
+/**
+ * For each entry in the object, call the function with the key and value.
+ *
+ * @param {Object<any, any>} obj - The object to iterate over.
+ * @param {Function} fn - The function to call for each entry.
+ *
+ * @returns {void}
+ */
+const forEachEntry = (obj, fn) => {
+  const generator = obj && obj[Symbol.iterator];
 
-  var iterator = generator.call(obj);
+  const iterator = generator.call(obj);
 
-  var result;
+  let result;
 
   while ((result = iterator.next()) && !result.done) {
-    var pair = result.value;
+    const pair = result.value;
     fn.call(obj, pair[0], pair[1]);
   }
 }
 
-function matchAll(regExp, str) {
-  var matches;
-  var arr = [];
+/**
+ * It takes a regular expression and a string, and returns an array of all the matches
+ *
+ * @param {string} regExp - The regular expression to match against.
+ * @param {string} str - The string to search.
+ *
+ * @returns {Array<boolean>}
+ */
+const matchAll = (regExp, str) => {
+  let matches;
+  const arr = [];
 
   while ((matches = regExp.exec(str)) !== null) {
     arr.push(matches);
@@ -465,47 +484,130 @@ function matchAll(regExp, str) {
   return arr;
 }
 
-var isHTMLForm = kindOfTest('HTMLFormElement');
+/* Checking if the kindOfTest function returns true when passed an HTMLFormElement. */
+const isHTMLForm = kindOfTest('HTMLFormElement');
 
-var hasOwnProperty = (function resolver(_hasOwnProperty) {
-  return function(obj, prop) {
-    return _hasOwnProperty.call(obj, prop);
-  };
-})(Object.prototype.hasOwnProperty);
-
-module.exports = {
-  isArray: isArray,
-  isArrayBuffer: isArrayBuffer,
-  isBuffer: isBuffer,
-  isFormData: isFormData,
-  isArrayBufferView: isArrayBufferView,
-  isString: isString,
-  isNumber: isNumber,
-  isObject: isObject,
-  isPlainObject: isPlainObject,
-  isUndefined: isUndefined,
-  isDate: isDate,
-  isFile: isFile,
-  isBlob: isBlob,
-  isFunction: isFunction,
-  isStream: isStream,
-  isURLSearchParams: isURLSearchParams,
-  isStandardBrowserEnv: isStandardBrowserEnv,
-  forEach: forEach,
-  merge: merge,
-  extend: extend,
-  trim: trim,
-  stripBOM: stripBOM,
-  inherits: inherits,
-  toFlatObject: toFlatObject,
-  kindOf: kindOf,
-  kindOfTest: kindOfTest,
-  endsWith: endsWith,
-  toArray: toArray,
-  isTypedArray: isTypedArray,
-  isFileList: isFileList,
-  forEachEntry: forEachEntry,
-  matchAll: matchAll,
-  isHTMLForm: isHTMLForm,
-  hasOwnProperty: hasOwnProperty
+const toCamelCase = str => {
+  return str.toLowerCase().replace(/[_-\s]([a-z\d])(\w*)/g,
+    function replacer(m, p1, p2) {
+      return p1.toUpperCase() + p2;
+    }
+  );
+};
+
+/* Creating a function that will check if an object has a property. */
+const hasOwnProperty = (({hasOwnProperty}) => (obj, prop) => hasOwnProperty.call(obj, prop))(Object.prototype);
+
+/**
+ * Determine if a value is a RegExp object
+ *
+ * @param {*} val The value to test
+ *
+ * @returns {boolean} True if value is a RegExp object, otherwise false
+ */
+const isRegExp = kindOfTest('RegExp');
+
+const reduceDescriptors = (obj, reducer) => {
+  const descriptors = Object.getOwnPropertyDescriptors(obj);
+  const reducedDescriptors = {};
+
+  forEach(descriptors, (descriptor, name) => {
+    if (reducer(descriptor, name, obj) !== false) {
+      reducedDescriptors[name] = descriptor;
+    }
+  });
+
+  Object.defineProperties(obj, reducedDescriptors);
+}
+
+/**
+ * Makes all methods read-only
+ * @param {Object} obj
+ */
+
+const freezeMethods = (obj) => {
+  reduceDescriptors(obj, (descriptor, name) => {
+    const value = obj[name];
+
+    if (!isFunction(value)) return;
+
+    descriptor.enumerable = false;
+
+    if ('writable' in descriptor) {
+      descriptor.writable = false;
+      return;
+    }
+
+    if (!descriptor.set) {
+      descriptor.set = () => {
+        throw Error('Can not read-only method \'' + name + '\'');
+      };
+    }
+  });
+}
+
+const toObjectSet = (arrayOrString, delimiter) => {
+  const obj = {};
+
+  const define = (arr) => {
+    arr.forEach(value => {
+      obj[value] = true;
+    });
+  }
+
+  isArray(arrayOrString) ? define(arrayOrString) : define(String(arrayOrString).split(delimiter));
+
+  return obj;
+}
+
+const noop = () => {}
+
+const toFiniteNumber = (value, defaultValue) => {
+  value = +value;
+  return Number.isFinite(value) ? value : defaultValue;
+}
+
+export default {
+  isArray,
+  isArrayBuffer,
+  isBuffer,
+  isFormData,
+  isArrayBufferView,
+  isString,
+  isNumber,
+  isBoolean,
+  isObject,
+  isPlainObject,
+  isUndefined,
+  isDate,
+  isFile,
+  isBlob,
+  isRegExp,
+  isFunction,
+  isStream,
+  isURLSearchParams,
+  isTypedArray,
+  isFileList,
+  forEach,
+  merge,
+  extend,
+  trim,
+  stripBOM,
+  inherits,
+  toFlatObject,
+  kindOf,
+  kindOfTest,
+  endsWith,
+  toArray,
+  forEachEntry,
+  matchAll,
+  isHTMLForm,
+  hasOwnProperty,
+  hasOwnProp: hasOwnProperty, // an alias to avoid ESLint no-prototype-builtins detection
+  reduceDescriptors,
+  freezeMethods,
+  toObjectSet,
+  toCamelCase,
+  noop,
+  toFiniteNumber
 };