Как определить, сколько функций зарегистрировано

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

Что такое функция и как она регистрируется

Функция — это именованный блок кода, предназначенный для выполнения конкретной задачи. Она может принимать параметры, возвращать значение и вызываться многократно. Регистрация функции происходит в момент её объявления или динамического добавления в доступное пространство имён, глобальный объект или реестр.
В статических языках, таких как C++ или Java, функции регистрируются на этапе компиляции. Компилятор фиксирует каждое объявление, создавая символы в таблице символов. В интерпретируемых языках, например JavaScript или Python, регистрация происходит во время выполнения. Функция становится доступной сразу после интерпретации строки с её объявлением.
Различают явную и неявную регистрацию. Явная — когда разработчик прямо указывает имя функции: function myFunc() {}. Неявная — через присваивание переменной: const func = () => {}, что создаёт ссылку, но не всегда добавляет функцию в общий реестр.

Для корректного подсчёта важно понимать, что считать «зарегистрированной» функцией. Это может быть:

• Любое объявление с ключевым словом function;
• Стрелочные функции и функциональные выражения;
• Методы классов и объектов;
• Асинхронные функции и генераторы.

Каждый из этих типов требует отдельного подхода при анализе, особенно если используется динамическая регистрация через window.funcName = function(){} или globalThis.register().

Методы определения количества функций

Существует три основных метода подсчёта: текстовый анализ, синтаксический разбор и выполнение кода. Каждый имеет свои преимущества и ограничения.
Первый — текстовый поиск с использованием регулярных выражений. Подходит для быстрой оценки. Например, команда grep -r "function " . в терминале найдёт все строки с ключевым словом function. Однако этот способ часто даёт ложные срабатывания: комментарии, строки с текстом «function» и объявления внутри строк попадут в выборку.
Более точный — синтаксический анализ. Здесь используется Abstract Syntax Tree (AST). Инструменты вроде Esprima для JavaScript или ast-модуля в Python строят дерево кода и позволяют точно найти все узлы типа FunctionDeclaration, FunctionExpression, ArrowFunctionExpression и т.д.
Третий метод — runtime-анализ. Он подразумевает запуск кода и сканирование окружения. Например, в JavaScript можно перебрать все свойства объекта window и проверить, является ли каждое из них функцией:

1. Выполнить скрипт в контролируемой среде;
2. Пройти по всем свойствам глобального объекта;
3. Отфильтровать только те, где typeof prop === 'function';
4. Исключить встроенные функции (console.log, setTimeout и др.).

Выбор метода зависит от цели:

• Для аудита безопасности — предпочтителен AST + runtime;
• Для оценки трудозатрат — достаточно текстового анализа с ручной проверкой;
• Для CI/CD — автоматизированный AST-сканер в пайплайне.

Особенности по языкам программирования

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

JavaScript / TypeScript

В JS функции могут быть объявлены множеством способов: через function, стрелочные функции, методы объектов, классовые методы, IIFE. Также возможна динамическая регистрация: globalThis['myFunc'] = function(){}.
Для точного подсчёта нужно учитывать:

• ES6+ синтаксис (классы, декораторы);
• Модульную систему (ESM, CommonJS);
• Транспиляцию (Babel может изменять структуру).

Инструменты: ESLint с кастомным правилом, Babel parser, Prettier API.

Python

В Python функции объявляются через def, а также существуют лямбды. Методы классов тоже считаются функциями, но их стоит отделять при анализе.
Особенность: функции являются объектами первого класса. Их можно передавать, присваивать, регистрировать динамически: globals()['my_func'] = lambda: None.
Для подсчёта используйте модуль ast:

import ast
tree = ast.parse(source_code)
functions = [node for node in ast.walk(tree) if isinstance(node, ast.FunctionDef)]

PHP

В PHP есть глобальные функции, методы классов и анонимные функции. Глобальные функции регистрируются в пространстве имён и доступны через get_defined_functions().
Пример:

$funcs = get_defined_functions();
echo count($funcs['user']); // пользовательские функции

Однако этот способ работает только во время выполнения и не покрывает функции, определённые в неисполняемых условиях.

C/C++

В компилируемых языках функции регистрируются на уровне компоновки. Используйте nm или objdump для анализа бинарных файлов:

nm -C your_binary | grep " T "

Символ T означает, что функция находится в секции текста (текстовый сегмент).

Инструменты для автоматизации подсчёта

Современные IDE и CLI-инструменты значительно упрощают задачу. Вот наиболее эффективные решения.

Universal Ctags

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

ctags -R --c-kinds=+p --c++-kinds=+p .
cat tags | grep "^T|^F" | wc -l

Параметры:

• -R — рекурсивный обход;
• --c-kinds=+p — включить прототипы функций;
• wc -l — подсчёт строк.

ESLint (JavaScript)

Создайте кастомное правило, которое будет считать узлы функций:

module.exports = {
 rules: {
 'count-functions': {
 create(context) {
 let count = 0;
 return {
 FunctionDeclaration() { count++; },
 FunctionExpression() { count++; },
 ArrowFunctionExpression() { count++; },
 'Program:exit'() {
 context.report({ message: `Найдено функций: ${count}` });
 }
 };
 }
 }
 }
};

Запустите: eslint . --rule 'count-functions: 2'

Pyflakes / pylint (Python)

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

CodeQL (GitHub)

Мощный инструмент для анализа кода через запросы. Пример запроса для поиска функций в JavaScript:

from FunctionDeclaration fd
select fd, "Эта функция названа " + fd.getName()

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

Типичные ошибки и как их избежать

Даже опытные разработчики допускают просчёты при подсчёте функций. Вот самые распространённые ошибки.

Счёт по ключевым словам без контекста

Регулярное выражение /functions*[a-zA-Z]/g захватит комментарии, строки и шаблонные литералы. Решение — использовать парсер, а не текстовый поиск.

Учёт встроенных функций

В runtime-анализе легко посчитать Array.prototype.map как пользовательскую функцию. Фильтруйте по пространству имён или сравнивайте с белым списком стандартных функций.

Игнорирование динамической регистрации

Если функция создаётся через new Function() или присваивается в window динамически, статические инструменты её не увидят. Требуется комбинированный подход.

Подсчёт методов как отдельных функций

Метод класса — это не глобальная функция. Если цель — оценить объём бизнес-логики, методы стоит группировать по классам.

Несогласованность между окружениями

Код может регистрировать разное количество функций в dev, staging и production из-за условной загрузки модулей. Анализируйте целевое окружение.

Экспертное мнение

Точность подсчёта функций напрямую влияет на метрики качества кода. Чрезмерное количество функций может указывать на фрагментацию, а слишком малое — на монолитность. Оптимальный диапазон — от 50 до 300 функций на модуль в зависимости от сложности.
Автоматизация — ключ к стабильности. Настройте pre-commit хуки или CI-задачи, которые будут выводить отчёт о количестве функций при каждом изменении. Это помогает отслеживать рост сложности.
При анализе legacy-кода важно учитывать историю изменений. Некоторые функции могут быть закомментированы или удалены, но всё ещё числиться в логах. Используйте git blame и diff для проверки актуальности.
Для микросервисных архитектур подсчёт следует проводить по сервисам отдельно, а затем агрегировать. Централизованная база метрик позволяет выявлять аномалии и планировать рефакторинг.

Вопросы и ответы

Заключение

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

• Используйте AST-парсеры для максимальной точности.
• Учитывайте особенности языка и среды выполнения.
• Фильтруйте встроенные и служебные функции.
• Автоматизируйте подсчёт в CI/CD.
• Комбинируйте методы для полного покрытия.