JSON Formatting & Line-Level Linting Architecture

Formatting unformatted JSON transforms dense single-line network payloads into structured, human-readable representations.

1. Indentation Mechanics & Spacing Algorithms

The JSON formatter supports 2-space, 4-space, and tab-based recursive tree formatting.

// High-performance native formatting
function formatJson(rawText, indentLevel = 2) {
  const parsed = JSON.parse(rawText);
  return JSON.stringify(parsed, null, indentLevel);
}

2. Line and Column Error Pinpointing

When parsing fails, the linter identifies the exact byte offset, calculating:

• Line Number: Count of newline characters (\n) prior to the error offset + 1.
• Column Number: Number of characters between the previous newline and the error offset.
• Error Excerpt: A 3-line contextual window with an arrow pointer directly beneath the offending character.

3. Key Sorting & Deterministic Canonical JSON

In cryptographic workflows, deterministic hashing, and Git version control, sorting object keys alphabetically ensures idempotent diffs:

function sortObjectKeys(obj) {
  if (typeof obj !== 'object' || obj === null) return obj;
  if (Array.isArray(obj)) return obj.map(sortObjectKeys);
  return Object.keys(obj).sort().reduce((acc, key) => {
    acc[key] = sortObjectKeys(obj[key]);
    return acc;
  }, {});
}

4. Best Practices for Large JSON Payloads

• Offload formatting of files over 1MB to Web Workers to prevent main-thread UI jank.
• Use streaming serializers for memory-constrained environments.