listLimit property
final
Maximum list index that will be honored when decoding bracket indices.
Keys like a[9999999]
can cause excessively large sparse lists; above
this limit, indices are treated as string map keys instead.
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;