listLimit property

int listLimit
final

Maximum list size/index that will be honored when decoding bracket lists.

Keys like a[9999999] can cause excessively large sparse lists; above this limit, indices are treated as string map keys instead. The same limit also applies to empty-bracket pushes (a[]) and duplicate combines: once growth exceeds the limit, the list is converted to a map with string indices to preserve values (matching Node qs arrayLimit semantics).

Negative values: passing a negative listLimit (e.g. -1) disables numeric‑index parsing entirely — any bracketed number like a[0] or a[123] is treated as a string map key, not as a list index (i.e. lists are effectively disabled).

When throwOnLimitExceeded is true and listLimit is negative, any operation that would grow a list (e.g. a[] pushes, comma‑separated values when comma is true, or nested pushes) will throw a RangeError.

Implementation

final int listLimit;