Как узнать тип объекта в 1С: 5 способов для разработчиков

Определение типа объекта в 1С:Предприятие — одна из самых частых задач, с которыми сталкиваются разработчики при отладке, создании универсальных обработок или интеграции систем. Без точного понимания, с каким именно объектом вы работаете — документом, справочником, регистром или перечислением — невозможно корректно построить логику программы. Проблема усложняется тем, что в разных версиях платформы 1С 8.3 и 1С 8.2 доступны различные инструменты для этой цели, а некоторые методы работают неочевидным образом.

Эта статья не просто перечислит способы определения типа — она раскроет нюансы каждого подхода, покажет, как обходить типичные ошибки (например, с Неопределено или NULL), и предоставит готовые кодовые примеры для копирования. Особое внимание уделено различиям между проверкой типа значения и типа метаданных объекта, что часто путают даже опытные программисты. Если вы когда-либо получали ошибку"Тип не определен (TypeNotDefined)" или"Ошибка приведения типа (TypeCastError)", здесь вы найдете системное решение.

1. Базовый метод: функция `ТипЗнч`

Самый простой и универсальный способ — использование встроенной функции ТипЗнч. Она возвращает строку с именем типа переданного значения и работает во всех версиях платформы, начиная с 1С 7.7. Основное преимущество метода — его безопасность: функция не вызывает исключений, даже если передать ей Неопределено или NULL.

Примеры использования:

// Пример 1: Проверка типа переменной
Перем = Справочники.Номенклатура.НайтиПоНаименованию("Товар 1");
Сообщить(ТипЗнч(Перем)); // Вернет"СправочникОбъект.Номенклатура"

// Пример 2: Работа с массивом
Массив = Новый Массив;
Массив.Добавить(100);
Массив.Добавить("Строка");
Для Каждого Элемент Из Массив Цикл
Сообщить(ТипЗнч(Элемент)); // Выведет"Число" и"Строка"
КонецЦикла;

✅ Работает со всеми примитивными типами (Число, Строка, Дата и т.д.)
✅ Возвращает полное имя типа для объектов метаданных (например, ДокументОбъект.РеализацияТоваровУслуг)
⚠️ Не различает Неопределено и NULL — для обоих вернет "Неопределено"
⚠️ Для динамических списков и запросов возвращает обобщенные типы ("ДинамическийСписок", "Запрос")

Ограничение метода: ТипЗнч не позволяет отличить ссылку на объект от самого объекта. Например, для документа она вернет одно и то же значение независимо от того, передали вы ссылку или объект в памяти. Для таких случаев потребуются более продвинутые техники.

2. Проверка типа через метаданные: метод `Метаданные`

Если вам нужно не просто узнать тип значения, а проверить принадлежность объекта к конкретному типу метаданных (например, убедиться, что это именно справочник "Контрагенты", а не любой другой), используйте метод Метаданные. Он доступен для всех объектов конфигурации и возвращает объект Метаданные, через который можно получить детальную информацию.

Ключевое отличие от ТипЗнч: этот метод работает только с объектами метаданных (справочниками, документами, регистрами и т.д.) и не подходит для примитивных типов. Зато он позволяет проверять иерархию типов — например, является ли объект документом или планом видов характеристик.

// Пример: Проверка, что объект - документ"ПоступлениеТоваров" Объект = Документы.ПоступлениеТоваров.СоздатьДокумент; Если ТипЗнч(Объект.Метаданные) = Тип("МетаданныеОбъекта.Документ") Тогда Сообщить("Это документ!"); КонецЕсли; // Пример: Получение полного пути типа

Сообщить(Объект.Метаданные.ПолноеИмя); //"Документ.ПоступлениеТоваров"

Метод	Работает с примитивами	Работает с объектами	Возвращает иерархию типов	Требует обработку исключений
`ТипЗнч`	✅ Да	✅ Да	❌ Нет	❌ Нет
`Метаданные`	❌ Нет	✅ Да	✅ Да	❌ Нет
`Попытка/Исключение`	✅ Да	✅ Да	❌ Нет	✅ Да

⚠️ Внимание: В 1С 8.3.20+ метод Метаданные может возвращать Неопределено для динамически созданных объектов (например, через Новый Структура). Всегда проверяйте результат на Неопределено перед использованием.

3. Продвинутый подход: проверка через `Попытка/Исключение`

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

Типичный сценарий: вам нужно отличить управляемую форму от обычной формы или проверить, реализует ли объект интерфейс IValueStorage. В таких случаях ТипЗнч бесполезен, а Попытка/Исключение становится единственным надежным решением.

// Пример: Проверка, является ли объект управляемой формой
Процедура ПроверитьТипФормы(Форма)
Попытка
Если Форма.ТипФормы = ТипФормы.Управляемая Тогда
Сообщить("Это управляемая форма!");
Иначе
Сообщить("Это обычная форма.");
КонецЕсли;
Исключение
Сообщить("Это не форма, а объект типа:" + ТипЗнч(Форма));
КонецПопытки;
КонецПроцедуры;

🔍 Позволяет проверять наличие методов/свойств без знания точного типа
🛡️ Безопасен для объектов с Неопределено или NULL
⚠️ Требует обработки исключений, что усложняет код
⚠️ Может быть медленнее стандартных методов из-за механизма исключений

💡

Если вам нужно часто проверять типы через Попытка/Исключение, вынесите логику в отдельную функцию с кэшированием результатов — это значительно ускорит работу кода.

4. Работа с типами в запросах и динамических списках

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

Рассмотрим два ключевых сценария:

Определение типа поля в результате запроса:

Запрос = Новый Запрос;
Запрос.Текст ="ВЫБРАТЬ
| Справочник1.Ссылка КАК Ссылка,
| Справочник1.Наименование КАК Наименование
|ИЗ
| Справочник.Номенклатура КАК Справочник1";
Результат = Запрос.Выполнить;
Выборка = Результат.Выбрать;

Пока Выборка.Следующий Цикл
// ТипЗнч(Выборка.Ссылка) вернет"СправочникСсылка.Номенклатура"
Сообщить(ТипЗнч(Выборка.Ссылка));
КонецЦикла;

Анализ динамического списка:

ДинСписок = Справочники.Номенклатура.Выбрать;
Если ТипЗнч(ДинСписок) = Тип("ДинамическийСписок") Тогда
// Получаем описание структуры списка
Описание = ДинСписок.Описание;
Для Каждого Колонка Из Описание.Колонки Цикл
Сообщить(Колонка.Имя +":" + Колонка.ТипЗначения.ИмяТипа);
КонецЦикла;
КонецЕсли;

⚠️ Внимание: В 1С 8.3.18+ для динамических списков появилось свойство .ТипЗначения, которое возвращает объект ОписаниеТипов. Это позволяет получить более детальную информацию о типах колонок, но требует обновления конфигурации.

5. Определение типа через рефлексию (для опытных разработчиков)

Для сложных случаев, когда нужно анализировать вложенные объекты или работать с динамически создаваемыми типами (например, при интеграции с внешними системами), применяют рефлексию — исследование структуры объекта во время выполнения. В 1С для этого используют:

🔄 Метод ПолучитьОбъект — для извлечения объекта из ссылки
📋 Свойство ЭтоГрупповое — для проверки группового объекта (например, справочника)
🔍 Функцию НайтиПоИмени — для поиска объекта по имени в метаданных

Пример рефлексивного анализа:

// Функция рекурсивного определения типа
Функция ПолучитьПолныйТип(Значение)
Если ТипЗнч(Значение) = Тип("Строка") Тогда
Возврат"Строка";
ИначеЕсли ТипЗнч(Значение) = Тип("Число") Тогда
Возврат"Число";
ИначеЕсли ТипЗнч(Значение) = Тип("СправочникСсылка") Тогда
Возврат"СправочникСсылка." + Значение.Метаданные.Имя;
ИначеЕсли ТипЗнч(Значение) = Тип("ДокументОбъект") Тогда
Возврат"ДокументОбъект." + Значение.Метаданные.Имя;
Иначе
Возврат ТипЗнч(Значение);
КонецЕсли;
КонецФункции;

Рефлексия особенно полезна при работе с:

📦 Внешними компонентами (например, COM-объектами)
🔗 HTTP-сервисами и JSON-данными
📊 Динамически создаваемыми структурами (через Новый Структура)

Как определить тип объекта из JSON?

При работе с JSON в 1С (например, через ЧтениеJSON) функция ТипЗнч вернет обобщенные типы: "Неопределено" для null, "Строка" для строк, "Число" для чисел, "Массив" для массивов и "Структура" для объектов. Чтобы различить кастомные типы, используйте поле "$type" в JSON или создавайте собственные обертки для десериализации.

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

Даже опытные разработчики допускают ошибки при определении типов в 1С. Вот наиболее распространенные ловушки и способы их обхода:

Путаница между Неопределено и NULL:
Функция ТипЗнч не различает эти значения — оба возвращают строку "Неопределено". Чтобы отличить их, используйте явную проверку:
```
Если Значение = Неопределено Тогда
Сообщить("Это Неопределено");
ИначеЕсли Значение = NULL Тогда
Сообщить("Это NULL");
КонецЕсли;
```
Ошибки приведения типов:
Попытка привести ссылку на документ к типу объекта документа (или наоборот) вызывает исключение. Всегда проверяйте тип перед приведением:
```
Если ТипЗнч(Объект) = Тип("ДокументСсылка.РеализацияТоваровУслуг") Тогда
ДокОбъект = Объект.ПолучитьОбъект;
КонецЕсли;
```
Проблемы с динамическими типами:
Объекты, созданные через Новый (например, Новый Структура), не имеют метаданных. Для них Метаданные вернет Неопределено.

⚠️ Внимание: В 1С 8.3.15–8.3.17 существовала ошибка, из-за которой ТипЗнч мог возвращать некорректные значения для объектов, полученных через WS-соединения. Если вы работаете с веб-сервисами, обновляйте платформу до версии 8.3.18+.

1. Убедиться, что значение не равно Неопределено или NULL

2. Проверить тип через ТипЗнч

3. Для объектов метаданных использовать Метаданные.Имя

4. Привести тип только после всех проверок-->

7. Практические примеры: от простого к сложному

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

Пример 1: Проверка типа параметра в общей функции

Задача: Написать универсальную функцию, которая принимает ссылку на документ или справочник и возвращает его наименование.

Функция ПолучитьНаименование(Ссылка)
Тип = ТипЗнч(Ссылка);
Если Найти(Тип,"СправочникСсылка.") > 0 Или Найти(Тип,"ДокументСсылка.") > 0 Тогда
Возврат Ссылка.Наименование;
Иначе
ВызватьИсключение"Некорректный тип параметра:" + Тип;
КонецЕсли;
КонецФункции;

Пример 2: Определение типа колонки в таблице значений

Задача: Пройти по всем колонкам ТаблицыЗначений и вывести их типы.

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Дата", Новый ОписаниеТипов("Дата"));
ТЗ.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число",,,, 10, 2));

Для Каждого Колонка Из ТЗ.Колонки Цикл
Сообщить(Колонка.Имя +":" + Колонка.ТипЗначения.ИмяТипа);
КонецЦикла;

Пример 3: Анализ типа в обработчике события

Задача: В обработчике события ПриИзменении формы определить, какое именно поле изменилось и какого оно типа.

Процедура ЭлементФормыПриИзменении(Элемент)
Если ТипЗнч(Элемент.Значение) = Тип("СправочникСсылка.Контрагенты") Тогда
// Логика для справочника Контрагенты
ИначеЕсли ТипЗнч(Элемент.Значение) = Тип("Дата") Тогда
// Логика для даты
КонецЕсли;
КонецПроцедуры;

💡

Для универсальных обработок всегда комбинируйте ТипЗнч с проверкой через Метаданные — это даст максимальную точность и защиту от ошибок.

FAQ: Частые вопросы по определению типов в 1С

Как отличить ссылку на объект от самого объекта?

Используйте комбинацию ТипЗнч и проверку на наличие метода .ПолучитьОбъект:

Если ТипЗнч(Объект) = Тип("СправочникСсылка.Номенклатура") Тогда
// Это ссылка
ОбъектПолный = Объект.ПолучитьОбъект;
КонецЕсли;

Для документов аналогично проверяйте Тип("ДокументСсылка.ИмяДокумента").

Почему ТипЗнч возвращает"Неопределено" для моего объекта?

Это происходит в трех случаях:

Переменная действительно не инициализирована (Неопределено).
Объект является NULL (например, из запроса с ЛЕВОЕ СОЕДИНЕНИЕ).
Вы работаете с динамическим типом, у которого нет явного описания в метаданных (например, результат вызова внешней компоненты).

Используйте дополнительную проверку: Если Значение = Неопределено Или Значение = NULL Тогда.

Как узнать тип поля в результате запроса, если оно может быть NULL?

В описании результата запроса (Результат.Описание) для каждого поля указан его тип. Но если значение NULL, ТипЗнч вернет "Неопределено". Решение:

Описание = Результат.Описание;
ТипПоля = Описание.Колонки[0].ТипЗначения.ИмяТипа; // Получаем тип из описания, а не из значения

Можно ли определить тип объекта, созданного через Новый?

Да, но с оговорками:

Для Новый Структура или Новый Массив — ТипЗнч вернет "Структура" или "Массив".
Для кастомных объектов (например, через Новый"МойОбъект") — вернет имя типа, заданное в конфигурации.
Для динамических объектов (созданных через AddIn) — может вернуть обобщенное имя (например, "COMОбъект").

Как проверить, что объект является формой?

Используйте проверку на наличие уникальных свойств формы:

Функция ЭтоФорма(Объект)
Возврат?(ТипЗнч(Объект) = Тип("Форма") Или ТипЗнч(Объект) = Тип("УправляемаяФорма"), Истина, Ложь);
КонецФункции;

Для управляемых форм дополнительно проверяйте свойство .ТипФормы.

Как определить тип объекта в 1С: от простых методов до глубокого анализа

1. Базовый метод: функция ТипЗнч

2. Проверка типа через метаданные: метод Метаданные

3. Продвинутый подход: проверка через Попытка/Исключение