Передача именованные аргументы функции Javascript

Question

Вызов функции Javascript с чем-то вроде

someFunction(1, true, 'foo'); 

не очень понятно, без знакомства с функцией.

я видел и использовал стиль, в котором комментарии вставленный назвать аргументы:

someFunction(/*itemsToAdd*/1, /*displayLabel*/ true, /*labelText*/ 'foo'); 

Но когда он выходит за пределы 3-х или более параметров, кажется, лучше передавать аргументы в формате JSON объект, который делает его не зависит от заказа и позволяет устанавливать значения по умолчанию в вызываемой функции

someFunction({'itemsToAdd':1, 'labelText':'foo', 'displayLabel':true}); 

Мой вопрос: какова общая практика в отрасли, и есть ли основополагающие причины не использовать ни один из этих методов. Например, Линт не любит второй метод.

Answer 1

Лично я бы просто grep имя функции и взглянуть на комментарий, связанный с ним. Укомплектованный код будет содержать комментарий выше функции, объясняющей, что такое аргументы и что он делает с ними, и вы можете просто вставить это над вызовом функции, если вам нужно объяснить, почему ваши аргументы являются такими, какими они есть.

Использование аргументов JSON для передачи аргументов похоже на способ добавления ненужных синтаксических разборов и, возможно, путаницу с сопровождающим - просто добавьте больше полей и передайте NULL в поля, где вы хотите значения по умолчанию, и вы можете объяснить, переходя в NULL в комментарии о вызове вместо того, чтобы просто не показывать их в JSON.