Как принято именовать клоны аргументов функции?

Question

[Максим]

Есть ли соглашения (best practice) о том, как именовать клоны ссылочных типов данных?

Как вы именуете клоны в таких ситуациях (когда имя сложно сократить)?

const foo = function foo(date) {
  const dateClone = new Date(date)
  // код, который мутирует dateClone и что-нибудь возвращает
}

Comments

[Ярослав Иванов]

Это ещё что за новые практики?

[Максим]

Ярослав Иванов, новые? Функция получает ссылку на объект в качестве переменной. Функция не должна изменять объект. Поэтому объект клонируется и все необходимые преобразования выполняются с клоном.

Например, для этой функции это осмысленно:

function foo(date) {
  const dateClone = new Date(date);
  return dateClone.setDate(1).getDay();
}

Возвращает она день недели первого числа месяца.

Или речь о чём-то другом?

[Ярослав Иванов]

Максим, А зачем? new Date и так возвращает новый объект.

[Даниил Попов]

Максим, я бы, в первую очередь, задумался о том, чтобы не называть функции «foo»)

Но если серьезно, то это вопрос наименования не клона объекта, а промежуточной переменной. Ну и назовите ее соотвественно firstDayOfMonth, если это первое число месяца

[Максим]

Даниил Попов, это только для примера :) В программе она называется по другому (countFirstDOTW, где DOTW - day of the week).

[Kovalsky]

Aleksandr-JS-Developer, к чему комментарий про spread? Копировать объекты можно кучей способов, а конкретно этот не очень хороший потому что 1) скопированы только значения и ссылки первого уровня и 2) проигнорирован класс объекта,

Максим, чо-то я сомневаюсь что для такого крошечного случая есть какое-то особое правило нейминга. По крайней мере я никогда не слышал,

[y0u]

Максим интересный вопрос, кстати. Как один из вариантов, это:

const foo = function foo(dateParam) {
  const date = new Date(dateParam)
}

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

[v1t3man]

Вы создаёте новую переменную, вот и называйте как новую переменную. В js нет "настоящего" клонирования как в php или c# например

Answer 1

[Vitaliy]

function getDayOfWeek1stDayOfMonth(date) {
  const firstDayOfMonth = new Date(date)
  firstDayOfMonth.setDate(1)
  return firstDayOfMonth.getDay();
}

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

Например

const dayOfWeek = dayjs(date).startOf('month').get('day')

Comments

[Максим]

Спасибо.

Нормально ли начинать названия функций с set и get, если это не сеттер и не геттер для какого-нибудь класса? У меня функции, обычно, методы какого-нибудь класса.

Хотя static методы можно так назвать, наверное.

В переменных и названиях функций можно опускать артикли?

[Vitaliy]

Максим, нормально, get и set не являются привилегией классов. Метод должен быть назван так, чтобы это отображало его предназначение. Артикли не нужны

[WbICHA]

Максим, главное помнить, что если функция начинается на get, то она обязана что-то да возвращать.

[Vitaliy]

WbICHA, и не делать никаких сайд-эффектов

Answer 2

[WbICHA]

Если отвечать на сам вопрос, на который так конкретного ответа и не дали, то лично я исхожу из пути наименьшего сопротивления.
А именно клоны не имеют приставки "клон", а вот к оригиналу присобачиваю Orig или Raw в зависимости от входных данных.

const foo = function foo(dateOrig) {
  const date = new Date(dateOrig)
  // код, который мутирует date и что-нибудь возвращает
}

Исхожу из логики, что dateOrig я использую 1 раз и забуду, а вот с date мне ещё работать предстоит, а значит меньше символов писать.)