Рекомендации по созданию лучше читаемого и обслуживаемого кода JavaScript

Рекомендации по созданию лучше читаемого и обслуживаемого кода JavaScript

От автора: три основных принципа разработки программного обеспечения: возможность рефакторинга, возможность повторного использования и читаемость.

Хороший код легко понять и поддерживать. Это достигает за счет трех R архитектуры программного обеспечения: Refactorability, Reusability и Readability.

Достижение трех R всегда было важно, но стало еще более значительным в последние годы. Продукты часто реализуются различными способами для различных аудиторий, устройств и платформ. Все это делает совместную работу и повторное использование компонентов абсолютно необходимым.

Код, который сложно выделить, повторно использовать и понять, не будет принят другими проектами. Вы можете проверить свой собственный код, опубликовав компоненты в Bit. Если вы создали его правильно, вам будет очень легко публиковать компоненты и повторно использовать их в других проектах.

Переменные

Значимые имена

Убедитесь, что переменные названы осмысленно. Это уменьшает необходимость в дополнительных комментариях, так как ваш код говорит сам за себя.

JavaScript. Быстрый старт

Изучите основы JavaScript на практическом примере по созданию веб-приложения

Узнать подробнее

Имена переменных с возможностью поиска

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

Избегайте ментального сопоставления

Не заставляйте людей запоминать контекст переменных. Переменные должны быть понятны, даже когда читатель не сумел проследить всю историю их появления.

Не добавляйте нежелательный контекст

Если класс или имя объекта говорит вам, что это такое, не включайте это в имя переменной.

Используйте аргументы по умолчанию

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

Используйте строгие проверки типа

Используйте === вместо ==. Это поможет избежать всевозможных ненужных проблем в дальнейшем. Если код не обрабатывается должным образом, это может существенно повлиять на логику программы.

Функции

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

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

JavaScript. Быстрый старт

Изучите основы JavaScript на практическом примере по созданию веб-приложения

Узнать подробнее

Минимум аргументов функции

В идеале вам следует избегать большого количества аргументов. Ограничение количества параметров функции поможет легче протестировать функцию.

Один или два аргумента — идеальный случай, и, если возможно, следует избегать создания трех. Что-то большее, чем это, должно быть консолидировано. Обычно, если у вас более двух аргументов, ваша функция пытается сделать слишком много. В тех случаях, когда это не так, как правило в качестве аргумента будет достаточно объекта более высокого уровня.

Функции должны делать только одно

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

Функции должны делать одно действие. Они должны делать это хорошо. Они должны делать только это. — Роберт К. Мартин (дядя Боб)

Удалите дубликаты кода

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

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

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

Не загрязняйте глобалы

Загрязнение глобальных объектов является плохой практикой в JavaScript, поскольку вы можете столкнуться с другой библиотекой, и пользователь вашего API будет в неведении, пока не получит исключение в рабочей среде. Например, если вы хотите расширить нативный метод JavaScript Array, чтобы получить метод diff, который будет показывать разницу между двумя массивами. Вы можете написать свой метод Array.prototype, но он может конфликтовать с другой библиотекой, которая пыталась вызвать тот же метод diff для реализации другой функции.

Вот почему было бы намного лучше просто использовать классы ES2015 / ES6 и просто расширить глобальные Array.

Хотя это обширная тема, я ограничил ее только переменными и функциями, чтобы сделать пост коротким. Я включил лишь часть того, что вы можете сделать, чтобы написать чистый код.

Автор: Mahdhi Rezvi

Источник: https://blog.bitsrc.io

Редакция: Команда webformyself.

JavaScript. Быстрый старт

Изучите основы JavaScript на практическом примере по созданию веб-приложения

Узнать подробнее

Full-Stack практика. Создание JavaScript блога

Создание веб-приложения с нуля на JavaScript, NodeJS, ExpressJS

Смотреть

Метки:

Похожие статьи:

Комментарии Вконтакте:

Комментарии Facebook: