JSON Formatter JavaScript — JSON.stringify()

const serverConfig = {
  host: "api.payments.internal",
  port: 8443,
  workers: 4,
  tls: { enabled: true, cert: "/etc/ssl/certs/api.pem" },
  rateLimit: { requestsPerMinute: 1000, burst: 50 }
}

console.log(JSON.stringify(serverConfig, null, 2))
// {
//   "host": "api.payments.internal",
//   "port": 8443,
//   "workers": 4,
//   "tls": {
//     "enabled": true,
//     "cert": "/etc/ssl/certs/api.pem"
//   },
//   "rateLimit": {
//     "requestsPerMinute": 1000,
//     "burst": 50
//   }
// }

const telemetryEvent = {
  eventId: "evt_3c7f9a2b",
  service: "checkout-api",
  severity: "warn",
  latencyMs: 342,
  region: "eu-central-1",
  tags: ["payment", "timeout", "retry"]
}

// wcięcie 2 spacje (najczęstsze w projektach JS)
JSON.stringify(telemetryEvent, null, 2)

// wcięcie tabulatorem (preferowane przez niektóre lintery i narzędzia konfiguracyjne)
JSON.stringify(telemetryEvent, null, '\t')

// zwarty — bez białych znaków (do transferu sieciowego)
JSON.stringify(telemetryEvent)
// {"eventId":"evt_3c7f9a2b","service":"checkout-api",...}

const order = {
  orderId: "ord_8f2a91bc",
  customer: {
    id: "usr_4421",
    email: "p.kowalski@przyklad.pl",
    passwordHash: "bcrypt:$2b$12$XKzV..."
  },
  items: [{ sku: "HDMI-4K-2M", qty: 2, unitPrice: 12.99 }],
  createdAt: "2026-03-10T14:22:00Z"
}

// Dołącz tylko bezpieczne pola do wyjścia logu
const safeLog = JSON.stringify(order, ["orderId", "items", "createdAt"], 2)
// {
//   "orderId": "ord_8f2a91bc",
//   "items": [{ "sku": "HDMI-4K-2M", "qty": 2, "unitPrice": 12.99 }],
//   "createdAt": "2026-03-10T14:22:00Z"
// }
// passwordHash i customer.email zostały wykluczone

const auditRecord = {
  requestId: "req_7d2e91",
  user: { id: "usr_4421", email: "p.kowalski@przyklad.pl", apiKey: "sk-live-eKx9..." },
  action: "update_billing",
  timestamp: new Date("2026-03-10T14:22:00Z"),
  durationMs: 87
}

function safeReplacer(key, value) {
  // Redaguj pola wyglądające jak sekrety lub dane osobowe
  if (key === "apiKey") return "[REDACTED]"
  if (key === "email") return value.replace(/(?<=.{2}).+(?=@)/, "***")
  return value
}

console.log(JSON.stringify(auditRecord, safeReplacer, 2))
// {
//   "requestId": "req_7d2e91",
//   "user": { "id": "usr_4421", "email": "p.***@przyklad.pl", "apiKey": "[REDACTED]" },
//   "action": "update_billing",
//   "timestamp": "2026-03-10T14:22:00.000Z",
//   "durationMs": 87
// }

const webhook = {
  eventType: "payment.succeeded",
  occurredAt: new Date("2026-03-10T14:22:00Z"),
  processedAt: new Date()
}

JSON.stringify(webhook, null, 2)
// {
//   "eventType": "payment.succeeded",
//   "occurredAt": "2026-03-10T14:22:00.000Z",
//   "processedAt": "2026-03-10T14:22:01.347Z"
// }

// Każdy obiekt z metodą toJSON() jest traktowany tak samo:
const custom = { toJSON: () => "custom-value", hidden: 42 }
JSON.stringify(custom) // '"custom-value"'

class Money {
  constructor(amount, currency) {
    this.amount = amount
    this.currency = currency
  }
  toJSON() {
    // Wywoływana automatycznie przez JSON.stringify
    return { amount: this.amount, currency: this.currency, formatted: `${this.currency} ${this.amount.toFixed(2)}` }
  }
}

class OrderId {
  constructor(id) { this.id = id }
  toJSON() { return this.id }  // Serializuj jako zwykły ciąg
}

const invoice = {
  invoiceId: new OrderId('inv_8f2a91bc'),
  subtotal: new Money(199.00, 'PLN'),
  tax:      new Money(15.92, 'PLN'),
  issuedAt: new Date('2026-03-10T14:22:00Z')
}

JSON.stringify(invoice, null, 2)
// {
//   "invoiceId": "inv_8f2a91bc",
//   "subtotal": { "amount": 199, "currency": "PLN", "formatted": "PLN 199.00" },
//   "tax": { "amount": 15.92, "currency": "PLN", "formatted": "PLN 15.92" },
//   "issuedAt": "2026-03-10T14:22:00.000Z"
// }

// To wyrzuca: TypeError: Do not know how to serialize a BigInt
// JSON.stringify({ sessionId: 9007199254741234n })

// Rozwiązanie: przekonwertuj BigInt na ciąg w replacerze
function bigIntReplacer(_key, value) {
  return typeof value === 'bigint' ? value.toString() : value
}

const metrics = {
  requestCount: 9007199254741234n,  // przekracza Number.MAX_SAFE_INTEGER
  service: "ingestion-worker",
  region: "eu-central-1"
}

JSON.stringify(metrics, bigIntReplacer, 2)
// {
//   "requestCount": "9007199254741234",
//   "service": "ingestion-worker",
//   "region": "eu-central-1"
// }

// To wyrzuca: TypeError: Converting circular structure to JSON
// const node = { id: "n1" }; node.self = node; JSON.stringify(node)

// Rozwiązanie: śledzenie widzianych obiektów za pomocą WeakSet
function circularReplacer() {
  const seen = new WeakSet()
  return function (_key, value) {
    if (typeof value === 'object' && value !== null) {
      if (seen.has(value)) return '[Circular]'
      seen.add(value)
    }
    return value
  }
}

const parent = { id: "node_parent", label: "root" }
const child  = { id: "node_child", parent }
parent.child = child  // cykliczne

JSON.stringify(parent, circularReplacer(), 2)
// {
//   "id": "node_parent",
//   "label": "root",
//   "child": { "id": "node_child", "parent": "[Circular]" }
// }

// Alternatywnie: npm install flatted
// import { stringify } from 'flatted'
// stringify(parent)  // obsługuje odwołania cykliczne natywnie

import { readFileSync, writeFileSync } from 'fs'

try {
  const raw = readFileSync('./config/database.json', 'utf8')
  const config = JSON.parse(raw)
  writeFileSync('./config/database.json', JSON.stringify(config, null, 2))
  console.log('Konfiguracja przeformatowana pomyślnie')
} catch (err) {
  console.error('Przeformatowanie konfiguracji nie powiodło się:', err.message)
  // JSON.parse wyrzuca SyntaxError, jeśli plik zawiera nieprawidłowy JSON
  // readFileSync wyrzuca ENOENT, jeśli plik nie istnieje
}

import { readFile, writeFile } from 'fs/promises'

async function reformatJson(filePath) {
  const raw = await readFile(filePath, 'utf8')
  const parsed = JSON.parse(raw)
  const formatted = JSON.stringify(parsed, null, 2)
  await writeFile(filePath, formatted, 'utf8')
  return { keys: Object.keys(parsed).length }
}

// Użycie
const { keys } = await reformatJson('./config/feature-flags.json')
console.log(`Przeformatowano ${keys} kluczy najwyższego poziomu`)

// Wzorzec 1: response.json() → czytelne wydrukowanie
async function debugEndpoint(url) {
  const res = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.API_TOKEN}` }
  })
  if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`)

  const data = await res.json()
  console.log(JSON.stringify(data, null, 2))
}

await debugEndpoint('https://api.stripe.com/v1/charges?limit=3')

// Wzorzec 2: response.text() → parsowanie → formatowanie
// Przydatne gdy chcesz zalogować zarówno surową odpowiedź, jak i czytelne wyjście
async function inspectRawResponse(url) {
  const res = await fetch(url)
  const raw = await res.text()

  console.log('Długość surowej odpowiedzi:', raw.length)
  try {
    const parsed = JSON.parse(raw)
    console.log('Sformatowane:')
    console.log(JSON.stringify(parsed, null, 2))
  } catch {
    console.error('Odpowiedź nie jest prawidłowym JSON:', raw.slice(0, 200))
  }
}

# Czytelne wydrukowanie package.json za pomocą node -p (print)
node -p "JSON.stringify(require('./package.json'), null, 2)"

# Czytelne wydrukowanie ze stdin (przyjazne dla potoków, działa w CI)
echo '{"port":3000,"env":"production"}' | node -e "
  const d = require('fs').readFileSync(0, 'utf8')
  console.log(JSON.stringify(JSON.parse(d), null, 2))
"

# Czytelne wydrukowanie odpowiedzi API zapisanej do pliku
cat api-response.json | node -e "
  process.stdin.setEncoding('utf8')
  let s = ''
  process.stdin.on('data', c => s += c)
  process.stdin.on('end', () => console.log(JSON.stringify(JSON.parse(s), null, 2)))
"

# Python jako zapasowe rozwiązanie (preinstalowany na macOS i większości dystrybucji Linux)
cat api-response.json | python3 -m json.tool

# jq — najszybszy i najbardziej rozbudowany (brew install jq / apt install jq)
cat api-response.json | jq .

# jq — czytelne wydrukowanie i filtrowanie w jednym kroku
cat api-response.json | jq '.data.users[] | {id, email}'

npm install fast-json-stringify

import fastJson from 'fast-json-stringify'

const serializeTelemetryEvent = fastJson({
  title: 'TelemetryEvent',
  type: 'object',
  properties: {
    eventId:   { type: 'string' },
    service:   { type: 'string' },
    severity:  { type: 'string', enum: ['info', 'warn', 'error'] },
    latencyMs: { type: 'integer' },
    timestamp: { type: 'string' },
    region:    { type: 'string' }
  },
  required: ['eventId', 'service', 'severity', 'latencyMs', 'timestamp']
})

const event = {
  eventId:   'evt_3c7f9a2b',
  service:   'checkout-api',
  severity:  'warn',
  latencyMs: 342,
  timestamp: new Date().toISOString(),
  region:    'eu-central-1'
}

const json = serializeTelemetryEvent(event)
// '{"eventId":"evt_3c7f9a2b","service":"checkout-api","severity":"warn",...}'

import { inspect } from 'util'

const payload = {
  requestId: "req_7d2e91",
  user: { id: "usr_4421", roles: ["admin", "billing"] },
  metadata: { ipAddress: "203.0.113.42", userAgent: "Mozilla/5.0" },
  createdAt: new Date()
}

// depth: null → rozwiń wszystkie zagnieżdżone poziomy; colors: true → kolory ANSI terminala
console.log(inspect(payload, { colors: true, depth: null }))

npm install stream-json

import { pipeline } from 'stream/promises'
import { createReadStream } from 'fs'
import { parser } from 'stream-json'
import { streamArray } from 'stream-json/streamers/StreamArray.js'

// events.json = tablica milionów obiektów — nigdy nie ładowana w całości do pamięci
await pipeline(
  createReadStream('./events.json'),
  parser(),
  streamArray(),
  async function* (source) {
    for await (const { value: event } of source) {
      if (event.severity === 'error') {
        console.log(JSON.stringify(event, null, 2))
      }
    }
  }
)

import { createReadStream } from 'fs'
import { createInterface } from 'readline'

// Format: jeden obiekt JSON na linię (logi, eksporty Kafka, BigQuery)
const rl = createInterface({
  input: createReadStream('./logs.ndjson'),
  crlfDelay: Infinity
})

for await (const line of rl) {
  if (!line.trim()) continue
  const entry = JSON.parse(line)
  if (entry.level === 'error') {
    console.log(JSON.stringify(entry, null, 2))
  }
}