uce/site/doc/pages/unit_info.txt
2026-06-15 10:53:36 +00:00

27 lines
1.0 KiB
Plaintext

:sig
DValue unit_info(String path = "")
:params
path : optional UCE unit path. If empty, uses the current executing unit.
return value : metadata tree for the resolved unit, or an empty tree if the unit cannot be resolved
:see
>runtime
units_list
unit_compile
0_Request
:content
Returns runtime metadata for a UCE compilation unit.
The returned tree is supplied by the host runtime and may include normalized source/artifact paths, compile/runtime status, ABI/wasm availability, timing counters, mtimes, and exported API declarations. Treat absent fields as unavailable rather than as false.
If `path` is relative, it is resolved by the same host unit resolver used for unit calls/components.
Because unit metadata lives in worker process memory, request and timing counters reflect the current runtime process, not an aggregate across every worker process.
Related:
- PHP: reflection-style metadata about included modules, callables, or exported capabilities
- JavaScript / Node.js: module metadata, reflection-like inspection, or manifest-based capability lookup