⌛️ Скрщния

Одна из самых болезненных вещей при прочтении кода - это сокращения. Часто люди используют сокращения подсмотрев их на stackoverflow или в коде других людей. Лично я избегаю сокращений максимально. Это делает код более целостным и заставляет больше думать над именами, которые могут получаться длинными из-за префиксов или постфиксов.

Давайте разберем частые сокращения:

const handleClick: MouseHandler = (e) => ...
const workWith = (i: number) => ...
const btnText = ...
const idx = ...
const l = array.length

Это популярные сокращения. За мою карьеру, даже я сталкивался с тем, что не понимал часть из них по коду. Например я все время думал что idx это тоже самое что и id, просто человек опечатался. Оказалось, что это index. Так же я сталкивался с сокращением i, которое уходило за рамки for и становилось головной болью, потому что какой-то другой разработчик мог начать использовать функцию так, что передавал не index, а какое-то другое число в функцию, которая принимала i и это приводило к скрытым ошибкам.

Так же, всякие сокращения по типу e внезапно могли начать использоваться не как event, а как emitter, или еще какая-то другая сущность. В связи с этим я выработал следующее правило:

Сокращения из одной буквы - это чистое зло. Сокращения по типу btn чуть меньшее зло.

В итоге, я начал избегать сокращения вовсе. В современном мире, где есть autocomplete, нет нужды экономить символы, пока они бесплатные.