Перейти к содержанию

BSL008 — Метод не должен содержать много возвратов

Кратко

Метод не должен содержать много возвратов

Идентификаторы

Поле Значение
Код правила BSL008
Совместимый псевдоним TooManyReturns
Серьёзность WARNING
Включено по умолчанию Да
Реализовано Да
Теги brain-overload

Поведение

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

Настройка и подавление

Код BSL### — основной стабильный идентификатор. Совместимый псевдоним принимается в select, ignore и совместимых блоковых комментариях.

[tool.onec-hbk-bsl]
select = ["BSL008"]
ignore = ["TooManyReturns"]

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

  • noqa:
Значение = "пример";  // noqa: BSL008
  • bsl-disable (совместимый вариант):
Значение = "пример";  // bsl-disable: BSL008
  • совместимый BSLLS-вариант:
Значение = "пример";  // BSLLS:TooManyReturns-off

Если тот же открывающий комментарий стоит на отдельной строке, он начинает диапазон. Закройте его парным маркером того же семейства:

// noqa: BSL008
// код без этой диагностики
// noqa-enable: BSL008

// bsl-disable: BSL008
// код без этой диагностики
// bsl-enable: BSL008

// BSLLS:TooManyReturns-off
// код без этой диагностики
// BSLLS:TooManyReturns-on

Чтобы отключить правило до конца файла, не добавляйте закрывающий noqa-enable, bsl-enable или BSLLS:…-on.

Открывающий и закрывающий маркеры должны принадлежать одному семейству.

Описание диагностики

Большое количество возвратов в методе (процедуре или функции) увеличивает его сложность и снижает производительность и восприятие.

Примеры

Пример плохого метода

Функция Пример(Условие)
    Если Условие = 1 Тогда
        Возврат "Проверка пройдена";
    ИначеЕсли Условие = 2 Тогда
        ВыполнитьДействие();
        Возврат "Проверка не пройдена";
    ИначеЕсли Условие > 7 Тогда
        Если ВыполнитьПроверку(Условие) Тогда
            Возврат "Проверка пройдена";
        Иначе
            Возврат "Проверка не пройдена";
        КонецЕсли;
    КонецЕсли;
    Возврат "";
КонецФункции

Источники