---
title: "getgc"
description: "Collects live functions, threads, userdata, lightuserdata, and buffers, optionally including tables, from this VM."
---

```lua
getgc(includeTables: boolean? = false): {any}
```

---

## Aliases

None.

---

## Arguments

<ParamField body="includeTables" type="boolean" default={"false"}>
  Whether to include tables in addition to the other collected GC object types.
</ParamField>

---

## Returns

<ResponseField name="objects" type="{any}">
  An array of live GC objects; tables are included only when requested.
</ResponseField>

Snapshot of live native GC-page objects; do not repeatedly scan on every render frame.

**Related types:** [Scripts types & behavior](/reference/scripts/types).

---

## Example

```lua
local values = getgc(true)
print("Objects:", #values)
```