You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

92 lines
2.5 KiB

3 years ago
'use strict';
3 years ago
import {VERSION} from '../env/data.js';
import AxiosError from '../core/AxiosError.js';
3 years ago
3 years ago
const validators = {};
3 years ago
// eslint-disable-next-line func-names
3 years ago
['object', 'boolean', 'number', 'function', 'string', 'symbol'].forEach((type, i) => {
3 years ago
validators[type] = function validator(thing) {
return typeof thing === type || 'a' + (i < 1 ? 'n ' : ' ') + type;
};
});
3 years ago
const deprecatedWarnings = {};
3 years ago
/**
* Transitional option validator
3 years ago
*
3 years ago
* @param {function|boolean?} validator - set to false if the transitional option has been removed
* @param {string?} version - deprecated version / removed since version
* @param {string?} message - some message with additional info
3 years ago
*
3 years ago
* @returns {function}
*/
validators.transitional = function transitional(validator, version, message) {
function formatMessage(opt, desc) {
return '[Axios v' + VERSION + '] Transitional option \'' + opt + '\'' + desc + (message ? '. ' + message : '');
}
// eslint-disable-next-line func-names
3 years ago
return (value, opt, opts) => {
3 years ago
if (validator === false) {
throw new AxiosError(
formatMessage(opt, ' has been removed' + (version ? ' in ' + version : '')),
AxiosError.ERR_DEPRECATED
);
}
if (version && !deprecatedWarnings[opt]) {
deprecatedWarnings[opt] = true;
// eslint-disable-next-line no-console
console.warn(
formatMessage(
opt,
' has been deprecated since v' + version + ' and will be removed in the near future'
)
);
}
return validator ? validator(value, opt, opts) : true;
};
};
/**
* Assert object's properties type
3 years ago
*
3 years ago
* @param {object} options
* @param {object} schema
* @param {boolean?} allowUnknown
3 years ago
*
* @returns {object}
3 years ago
*/
function assertOptions(options, schema, allowUnknown) {
if (typeof options !== 'object') {
throw new AxiosError('options must be an object', AxiosError.ERR_BAD_OPTION_VALUE);
}
3 years ago
const keys = Object.keys(options);
let i = keys.length;
3 years ago
while (i-- > 0) {
3 years ago
const opt = keys[i];
const validator = schema[opt];
3 years ago
if (validator) {
3 years ago
const value = options[opt];
const result = value === undefined || validator(value, opt, options);
3 years ago
if (result !== true) {
throw new AxiosError('option ' + opt + ' must be ' + result, AxiosError.ERR_BAD_OPTION_VALUE);
}
continue;
}
if (allowUnknown !== true) {
throw new AxiosError('Unknown option ' + opt, AxiosError.ERR_BAD_OPTION);
}
}
}
3 years ago
export default {
assertOptions,
validators
3 years ago
};