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: "ap-northeast-2",
  tags: ["payment", "timeout", "retry"]
}

// 2칸 들여쓰기 (JS 프로젝트에서 가장 일반적)
JSON.stringify(telemetryEvent, null, 2)

// 탭 들여쓰기 (일부 린터와 설정 도구가 선호)
JSON.stringify(telemetryEvent, null, '\t')

// 컴팩트 — 공백 없음 (네트워크 전송용)
JSON.stringify(telemetryEvent)
// {"eventId":"evt_3c7f9a2b","service":"checkout-api",...}

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

// 로그 출력에는 안전한 필드만 포함
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와 customer.email은 제외됨

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

function safeReplacer(key, value) {
  // 시크릿이나 개인정보처럼 보이는 필드 마스킹
  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": "ki***@example.kr", "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"
// }

// toJSON() 메서드를 가진 객체는 동일하게 처리됩니다:
const custom = { toJSON: () => "custom-value", hidden: 42 }
JSON.stringify(custom) // '"custom-value"'

class Money {
  constructor(amount, currency) {
    this.amount = amount
    this.currency = currency
  }
  toJSON() {
    // 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 }  // 순수 문자열로 직렬화
}

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

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

// 이것은 TypeError를 발생시킵니다: Do not know how to serialize a BigInt
// JSON.stringify({ sessionId: 9007199254741234n })

// 수정: replacer에서 BigInt를 문자열로 변환
function bigIntReplacer(_key, value) {
  return typeof value === 'bigint' ? value.toString() : value
}

const metrics = {
  requestCount: 9007199254741234n,  // Number.MAX_SAFE_INTEGER 초과
  service: "ingestion-worker",
  region: "ap-northeast-2"
}

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

// 이것은 TypeError를 발생시킵니다: Converting circular structure to JSON
// const node = { id: "n1" }; node.self = node; JSON.stringify(node)

// 수정: 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  // 순환 참조

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

// 또는: npm install flatted
// import { stringify } from 'flatted'
// stringify(parent)  // 순환 참조를 네이티브로 처리

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('설정 파일이 성공적으로 재포맷되었습니다')
} catch (err) {
  console.error('설정 재포맷 실패:', err.message)
  // 파일에 잘못된 JSON이 있으면 JSON.parse가 SyntaxError를 발생시킴
  // 파일이 없으면 readFileSync가 ENOENT를 발생시킴
}

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 }
}

// 사용 예시
const { keys } = await reformatJson('./config/feature-flags.json')
console.log(`최상위 키 ${keys}개가 재포맷되었습니다`)

// 패턴 1: response.json() → 예쁜 출력
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')

// 패턴 2: response.text() → 파싱 → 포맷
// 원시 응답과 예쁜 출력 모두 로깅하고 싶을 때 유용
async function inspectRawResponse(url) {
  const res = await fetch(url)
  const raw = await res.text()

  console.log('원시 응답 길이:', raw.length)
  try {
    const parsed = JSON.parse(raw)
    console.log('포맷된 결과:')
    console.log(JSON.stringify(parsed, null, 2))
  } catch {
    console.error('응답이 유효한 JSON이 아닙니다:', raw.slice(0, 200))
  }
}

# node -p (print)로 package.json 예쁘게 출력
node -p "JSON.stringify(require('./package.json'), null, 2)"

# 표준 입력에서 예쁘게 출력 (파이프 친화적, CI에서 동작)
echo '{"port":3000,"env":"production"}' | node -e "
  const d = require('fs').readFileSync(0, 'utf8')
  console.log(JSON.stringify(JSON.parse(d), null, 2))
"

# 파일에 저장된 API 응답 예쁘게 출력
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 폴백 (macOS와 대부분의 Linux 배포판에 사전 설치됨)
cat api-response.json | python3 -m json.tool

# jq — 가장 빠르고 기능이 풍부함 (brew install jq / apt install jq)
cat api-response.json | jq .

# jq — 예쁜 출력과 필터링을 한 번에
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:    'ap-northeast-2'
}

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 → 모든 중첩 레벨 펼치기; colors: true → ANSI 터미널 색상
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 = 수백만 개의 객체 배열 — 메모리에 완전히 로드되지 않음
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'

// 형식: 한 줄에 하나의 JSON 객체 (로그, 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))
  }
}