Шаблон дизайна JavaScript для вариантов со значениями по умолчанию?
// opt_options is optional
function foo(a, b, opt_options) {
// opt_c, opt_d, and opt_e are read from 'opt_options', only c and d have defaults
var opt_c = 'default_for_c';
var opt_d = 'default_for_d';
var opt_e; // e has no default
if (opt_options) {
opt_c = opt_options.c || opt_c;
opt_d = opt_options.d || opt_d;
opt_e = opt_options.e;
}
}
Вышеизложенное кажется ужасно многословным. Как лучше обрабатывать параметры аргументов с параметрами по умолчанию?
14 ответов
Теперь, когда я думаю об этом, я вроде как это:
function foo(a, b, opt_options) {
// Force opt_options to be an object
opt_options = opt_options || {};
// opt_c, opt_d, and opt_e are read from 'opt_options', only c and d have defaults
var opt_c = 'default_for_c' || opt_options.c;
var opt_d = 'default_for_d' || opt_options.d;
var opt_e = opt_options.e; // e has no default
}
Он использует jQuery.extend, но может быть заменен слиянием объектов из выбранной вами библиотеки или Object.assign в ES6.
function Module(options){
var defaults = {
color: 'red',
};
var actual = $.extend({}, defaults, options || {});
console.info( actual.color );
}
var a = new Module();
// Red
var b = new Module( { color: 'blue' } );
// Blue
Изменить: теперь также в underscore
или же lodash
!
function Module(options){
var actual = _.defaults(options || {}, {
color: 'red',
});
console.info( actual.color );
}
var a = new Module();
// Red
var b = new Module( { color: 'blue' } );
// Blue
В Javascript ES6 вы можете использовать Object.assign:
function Module(options = {}){
let defaults = {
color: 'red',
};
let actual = Object.assign({}, defaults, options);
console.info( actual.color );
}
В ES6/ES2015 есть несколько новых способов. С помощью Object.assign
:
options = Object.assign({}, defaults, options);
Использование деструктурирующего задания:
const { a = 1, b = 2 } = options;
Вы также можете использовать параметры функции деструктурирования:
const ƒ = ({a = 1, b = 2, c = 3} = {}) => {
console.log({ a, b, c });
};
Нет зависимостей!
Чтобы получить параметры по умолчанию без дополнительных зависимостей, я использую следующий шаблон:
var my_function = function (arg1, arg2, options) {
options = options || {};
options.opt_a = options.hasOwnProperty('opt_a') ? options.opt_a : 'default_opt_a';
options.opt_b = options.hasOwnProperty('opt_b') ? options.opt_b : 'default_opt_b';
options.opt_c = options.hasOwnProperty('opt_c') ? options.opt_c : 'default_opt_b';
// perform operation using options.opt_a, options.opt_b, etc.
};
Хотя я немного многословен, мне легко читать, добавлять / удалять опции и добавлять значения по умолчанию. Когда есть много вариантов, немного более компактная версия:
var my_function = function (arg1, arg2, options) {
var default_options = {
opt_a: 'default_opt_a',
opt_b: 'default_opt_b',
opt_c: 'default_opt_c'};
options = options || {};
for (var opt in default_options)
if (default_options.hasOwnProperty(opt) && !options.hasOwnProperty(opt))
options[opt] = default_options[opt];
// perform operation using options.opt_a, options.opt_b, etc.
};
И более компактная версия jQuery:
function func(opts) {
opts = $.extend({
a: 1,
b: 2
}, opts);
console.log(opts);
}
func(); // Object {a: 1, b: 2}
func({b: 'new'}); // Object {a: 1, b: "new"}
Using ES6 Spread Operator
function Example(opts) {
let defaults = { foo: 1, bar: 2 }
opts = { ...defaults, ...(opts || {}) }
console.log(opts);
}
Example({ bar: 3 })
Если вам нужно сделать это во многих последовательных функциях, способ стандартизировать процесс и ускорить его:
function setOpts (standard, user) {
if (typeof user === 'object' {
for (var key in user) {
standard[key] = user[key];
}
}
}
Тогда вы можете просто определить свои функции просто так:
var example = function (options) {
var opts = {
a: 1,
b: 2,
c:3
};
setOpts(opts, options);
}
Таким образом, вы определяете только один объект параметров внутри функции, который содержит значения по умолчанию.
Если вы хотите поставить дополнительную проверку, чтобы избежать наследования прототипа, первой функцией может быть:
function setOpts (standard, user) {
if (typeof user === 'object') {
Object.keys(user).forEach(function (key) {
standard[key] = user[key];
});
}
}
Последний случай не поддерживается для: IE <9, Chrome <5, Firefox <4, Safari <5
(вы можете проверить таблицу совместимости здесь)
Наконец, ECMAScript 6 предоставит нам лучший способ сделать это: параметры по умолчанию.
Хотя пройдет несколько месяцев, прежде чем это будет широко поддерживаться в разных браузерах.
Вот простой и понятный подход, надеюсь, это кому-то поможет:
function example(url, {title = false, check = false, wait = false} = {}){
console.log('url: ', URL);
console.log('title: ', title);
console.log('check: ', check);
console.log('wait: ', wait);
}
example('https://example.com', {wait: 20})
Вот результат выполнения кода выше:
url: https://example.com
title: false
check: false
wait: 20
Если у вас есть доступ к ES6 с предложением этапа 4 (например, с Babel), вы можете выполнить это с помощью распределения и деструктурирования.
const defaultPrintOptions = {
fontName: "times",
fontStyle: "normal",
fontSize: 10,
align: "left"
};
// Setting the null default isn't necessary but
// makes it clear that the parameter is optional.
// Could use {} but would create a new object
// each time the function is called.
function print(text, options = null) {
let {
fontName,
fontStyle,
fontSize,
align
} = {
...defaultPrintOptions,
...options
};
console.log(text, fontName, fontStyle, fontSize, align);
}
print("All defaults:");
print("Override some:", {
fontStyle: "italic",
align: "center"
});
print("Override all:", {
fontName: "courier",
fontStyle: "italic",
fontSize: 24,
align: "right"
});
Это также работает (но может создать больше объектов):
function myFunction({
text = "",
line = 0,
truncate = 100
} = {}) {
console.log(text, line, truncate);
}
(последний пример из Дэвида Уолша - ответ @wprl также упоминает это)
var mergeOptions = function mergeOptions(userOptions) {
// Default options
var options = {
height: "100px",
width: "100px" ,
color: "blue"
}
if (userOptions) {
Object.keys(userOptions).forEach(function (key) {
options[key] = userOptions[key]
})
}
return options;
}
Существует новый синтаксис javascript для простой установки значений по умолчанию, операторов логического присваивания:
// Super crazy this:
staticConfig.defaultPropsForFoo =
staticConfig.defaultPropsForFoo || {
myDefault: 'props'
}
// turns into:
staticConfig.defaultPropsForFoo ||= { myDefault: 'props' }
Также работает с нулевым оператором, если вы предпочитаете более строгую логическую семантику:
staticConfig.defaultPropsForFoo ??= { myDefault: 'props' }
(Возможно, мы всегда должны использовать
??=
версия но она тоже довольно новая)
Кроме того, я все время использую параметры по умолчанию, но этот синтаксис работает внутри любого деструктурирующего назначения:
const {
defaultPropsForFoo = { myDefault: 'props' },
...restConfig
} = staticConfig
Хотя Object.assign является довольно простым способом объединения опций со значениями по умолчанию, у него есть некоторые недостатки:
если вы хотите установить условные опции с тернарным оператором - он заменит значения по умолчанию даже для
undefined
ценности:const options = { logging: isProduction ? 'none' : undefined }; const defaults = { logging: 'verbose' } Object.assign({}, defaults, options); // {logging: undefined} !
если вы укажете неверное имя опции - вас не предупредят:
const options = { loging: 'none' // typo }; const defaults = { logging: 'verbose' } Object.assign({}, defaults, options); // {logging: 'verbose', loging: 'none'} !
Чтобы покрыть эти случаи, я создал крошечный пакет с плоскими опциями.
Он не перезаписывает значения по умолчанию для undefined
ценности:
const options = {
logging: isProduction ? 'none' : undefined
};
const defaults = {
logging: 'verbose'
}
flatOptions(options, defaults); // {logging: 'verbose'}
и предупреждает о неправильных именах опций:
const options = {
loging: 'none' // typo
};
const defaults = {
logging: 'verbose'
}
flatOptions(options, defaults); // throws "Unknown option: loging."
Надеюсь это поможет!
Увидев все решения, я предпочитаю следующий способ:
function example(firstArgument, optional = {}) {
const {
a = 123, // default value
b,
} = optional;
console.log(firstArgument, a, b);
}
И таким образом поддерживает несколько синтаксиса для вызова:
example(); // undefined 123 undefined
example("test"); // test 123 undefined
example("test", { a: 456 }); // test 456 undefined
example("test", { b: 456 }); // test 123 456
example("test", { a: 456, b: 123 }); // test 456 123
Я думаю, что вы ищете что-то вроде этого (извините за поздний ответ):
function foo(a, b, options) {
this.defaults = {
x: 48,
y: 72,
z: 35
};
for (var i in this.defaults) {
if (options[i] != "undefined") { this.defaults[i] = options[i]; }
}
// more code...
}
edit: извинения, взял это из какого-то старого кода... Вы должны убедиться, что используете метод hasOwnProperty(), чтобы убедиться, что вы не перебираете все в function.prototype
https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Object/hasOwnProperty