inspect()

Validation with error position — no repair suggestions.

Signature

JsonFast::inspect(string $json, ?int $output = OUTPUT_ARRAY): mixed

Parameters

Name	Type	Default	Description
$json	string	—	JSON text to inspect
$output	?int	OUTPUT_ARRAY	Output mode

Returns

Structure describing validity. When invalid, includes error line and column.

Typical array output:

// valid document
['valid' => true]

// invalid document
[
    'valid' => false,
    'error' => [
        'message' => '...',
        'line' => 3,
        'column' => 18,
    ],
]

When to use

Need	Method
Pass/fail only	validate()
Error location for logging or UI	inspect()
Repair flags before fixing	analyse()

Examples

$report = JsonFast::inspect($upload);

if (!$report['valid']) {
    logger()->warning('JSON parse failed', [
        'line' => $report['error']['line'],
        'column' => $report['error']['column'],
        'message' => $report['error']['message'],
    ]);
}

API error response:

$report = JsonFast::inspect($body);

if (!$report['valid']) {
    return [
        'error' => 'invalid_json',
        'line' => $report['error']['line'],
        'column' => $report['error']['column'],
    ];
}

Related

• analyse() — adds repairable and suggested flags
• validate() — boolean only