# Native JSON container shorthand parsing and type boundaries > Source-anchored research for Native JSON container shorthand parsing and type boundaries. Run status: COMPLETED. Parent: [MongoDB Aggregation Pipeline](https://llms-explorer.com/tree/mongodb-aggregation-pipeline/) · 4 facets · 14 facts · page: https://llms-explorer.com/tree/native-json-container-shorthand-parsing-and-type-boundaries/ ## How it works - $toObject retains the last value for duplicate field names. RFC 8259 recommends unique names because receivers differ; ECMA-404 defines syntax without mandating how a programming language internalizes JSON. Last-value behavior is a MongoDB mapping rule, not a universal JSON guarantee. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toObject.md) ## Problems, failure modes and limitations - Implementation-derived boundary in MongoDB r8.3.0: existing BSON arrays and objects do not get identity conversions to array/object, nor native array-to-object or object-to-array conversions. The dispatch tables lack these entries and raise ConversionFailure; onError can handle that failure. This was checked in source, not by executing a server. (low confidence) — [source](https://raw.githubusercontent.com/mongodb/mongo/r8.3.0/src/mongo/db/exec/expression/evaluate_math.cpp) ## Comparisons and alternatives - A valid JSON scalar is not sufficient input for these container parsers: both document errors for "123". RFC 8259 permits top-level scalar JSON values, so this failure is an operator acceptance boundary rather than proof that scalar JSON is invalid. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md) - The documented non-null inputs are a JSON-object string for $toObject, and a JSON-array string or supported subtype-9 binData vector for $toArray. Numeric input such as 123 is an unsupported conversion to array, rather than automatic singleton wrapping. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md) - These shorthands parse ordinary JSON containers: Extended JSON wrappers such as $oid and $date remain nested data rather than producing their BSON special types. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md) - ECMA-404 defines JSON syntax without prescribing how a programming language internalizes it. BSON type mapping and conversion acceptance must therefore come from MongoDB's contract, rather than being inferred solely from JSON syntax. (high confidence) — [source](https://ecma-international.org/publications-and-standards/standards/ecma-404/) ## Facts and statements - MongoDB 8.3 introduces conversion of JSON array and object strings through $convert and the $toArray/$toObject shorthand expressions. (high confidence) (verified as of 2026-10-27) — [source](https://www.mongodb.com/docs/v8.3/release-notes/8.3/) - MongoDB 8.3 introduced string-to-container conversions: {$toArray: expression} abbreviates {$convert: {input: expression, to: 'array'}}, and $toObject abbreviates the corresponding to: 'object' conversion. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md) - String parsing requires strict JSON: comments and trailing commas are rejected. $toArray requires a top-level array and rejects "{}"; $toObject requires a top-level object and rejects "[]". (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md) - Both shorthands return null for null or missing input. Conversion failures stop the aggregation; use $convert with onError and onNull to supply explicit fallback values. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md) - The documented input table for $toObject lists strings and null/missing. $toArray additionally supports subtype-9 vector binData: PACKED_BIT becomes booleans, INT8 integers, and FLOAT32 doubles. A native integer such as 123 is an unsupported array conversion. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md) - JSON syntax permits escaped U+0000 in strings, but MongoDB's object conversion rejects an embedded null byte in a field name. The documented input containing a key nam\u0000e fails with 'Illegal embedded null byte'. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toObject.md) - String inputs require valid JSON without comments or trailing commas, and their top-level container must match the target. Thus '{}' fails for $toArray, '[]' fails for $toObject, and the standalone string '123' fails for both. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md) - Parsed integers map to BSON int within signed 32-bit range, long within signed 64-bit range, and double beyond that range; decimal-point or exponent notation maps to double. Large integers can therefore lose precision. (high confidence) — [source](https://www.mongodb.com/docs/manual/reference/operator/aggregation/toArray.md)