listLimit property

int listLimit
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;