---
title: GetComponentData
summary: Чтение данных компонента в Lua UI на примере имени объекта.
section: reference
kind: api
status: reference
tags: ["GetComponentData","lua","component","ID","API"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## Возвращаемое значение

| Тип | Значение |
| --- | --- |
| [`any`](wiki:type-results), ... | По результату на запрошенное поле. Поле name в примере является string; у других полей свои контракты. |

[Типы и методы](wiki:types)

## Используемая форма


**Слой:** Lua UI игры.



```lua
local name = GetComponentData(component, "name")
```



**Что произойдёт:** Если component является допустимой ссылкой, name получает имя компонента. Например, для объекта с именем Scout это строка "Scout". В журнал значение автоматически не выводится.



| Аргумент | Назначение |
| --- | --- |
| `component` | Script component ID в форме, ожидаемой UI-функцией |
| `"name"` | Имя запрашиваемого поля в этом примере |


Объект должен быть разрешён в текущем процессе. Здесь `component` - заранее полученный ID, а не переменная, которую игра создаёт автоматически.



## Наблюдение проекта


После переименования считайте настоящее имя объекта и сравните с ожидаемым. Обновление текста своего окна само по себе не доказывает, что имя изменилось в игре.



## Ошибки типов


Не передавайте сюда FFI cdata только потому, что она тоже обозначает объект. В исследовании навигации UI handle, числовой ID и UniverseID требовали разных путей преобразования.



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



См. [ID и точность](wiki:ids-and-precision).