⌛️ Скрщния
Одна из самых болезненных вещей при прочтении кода - это сокращения. Часто люди используют сокращения подсмотрев их на 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, нет нужды экономить символы, пока они бесплатные.