Whitespace-only input
The document contains only spaces, tabs or newlines. Same family as empty input — a file was created but never filled.
How to fix it
Treat whitespace-only as empty and handle it before parsing.
Trimming before the emptiness check catches both this and the zero-byte case in one branch.
What each parser reports
Every message below was captured by running this exact input through the parser named. 15 of 21 parsers rejected it; 6 accepted it.
| Parser | Exact message |
|---|---|
| CPython json.loads CPython 3.12.3 | Expecting value: line 2 column 3 (char 6)what this message means → |
| encoding/json Unmarshal Go go1.22.2 | unexpected end of JSON inputwhat this message means → |
| Gson Java 21.0.12 | accepted — no error |
| Gson JsonParser (lenient off) Java 21.0.12 | accepted — no error |
| hjson Node.js 22.22.2 | accepted — no error |
| Jackson ObjectMapper Java 21.0.12 | accepted — no error |
| JavaScriptCore JSON.parse JavaScriptCore (Bun 1.4.1) | JSON Parse error: Unexpected EOFwhat this message means → |
| json-bigint Node.js 22.22.2 | Unexpected '' |
| JSON5 Node.js 22.22.2 | JSON5: invalid end of input at 2:3what this message means → |
| JSON::PP Perl 5.038002 | malformed JSON string, neither array, object, number, string or atom, at character offset 6 (before "(end of string)")what this message means → |
| json_decode PHP 8.3.6 | Syntax error |
| Newtonsoft.Json JsonConvert Newtonsoft.Json 13.0.3 on .NET 8.0.30 | accepted — no error |
| Newtonsoft.Json JsonTextReader Newtonsoft.Json 13.0.3 on .NET 8.0.30 | accepted — no error |
| orjson CPython 3.12.3 | input data is empty: line 1 column 1 (char 0)what this message means → |
| Ruby JSON.parse Ruby 3.2.3 | unexpected token at '' |
| serde_json::from_str Rust (serde_json 1.x) | EOF while parsing a value at line 2 column 2what this message means → |
| SpiderMonkey JSON.parse SpiderMonkey 115 | JSON.parse: unexpected end of data at line 2 column 3 of the JSON datawhat this message means → |
| System.Text.Json Deserialize .NET 8.0.30 | The input does not contain any JSON tokens. Expected the input to start with a valid JSON token, when isFinalBlock is true. Path: $ | LineNumber: 1 | BytePositionInLine: 2.what this message means → |
| System.Text.Json JsonDocument .NET 8.0.30 | The input does not contain any JSON tokens. Expected the input to start with a valid JSON token, when isFinalBlock is true. LineNumber: 1 | BytePositionInLine: 2.what this message means → |
| ujson CPython 3.12.3 | Expected object or value |
| V8 JSON.parse Node.js 22.22.2 | Unexpected end of JSON inputwhat this message means → |
What the specification says
The exact sections that govern this error. Descriptions are our paraphrase; follow the links for the normative text.
| Body | Section |
|---|---|
| IETF | A JSON text is a single value with optional surrounding whitespace ( JSON-text = ws value ws). The token set is six structural characters, strings, numbers and three literal names — nothing else. |
| Ecma International | Lists the six structural tokens, the three literal name tokens, and the four whitespace code points. Whitespace is not allowed within a token. |
Other errors in this category
Empty string passed to a JSON parser
The document is zero bytes. Almost always an upstream failure: an HTTP call that returned 204, a file that was never written, a va…
Extra data after a JSON document
Two complete documents concatenated. Usually a file appended to rather than overwritten, or several API responses written to the s…
Trailing characters after a JSON document
Non-whitespace content after the closing brace — a stray word, a shell prompt captured with the output, or a log line appended to …
HTML received where JSON was expected
The response body is an HTML page, not JSON. The server returned an error page, a login redirect, a proxy or captive-portal inters…
The literal string 'undefined' as a JSON document
A JavaScript variable holding `undefined` was interpolated into a string and sent as the body. `String(undefined)` is `"undefined"…
Bare unquoted word as a JSON document
A single token with no quotes. Either a plain-text response being parsed as JSON, or a string value that was never quoted.…
Whole JSON document wrapped in quotes
The document is double-encoded — a JSON string containing JSON, or a shell variable that kept its surrounding quotes.…
NDJSON fed to a whole-document JSON parser
Newline-delimited JSON: one complete document per line. Each line is valid on its own, but the file as a whole is not a single JSO…