formatJson

JSON را خوانا می‌آراید. هم شیء می‌پذیرد و هم رشتهٔ JSON‌ای که بخواهید دوباره بیارایید.

API

formatJson(value, onError?, indent?)

پارامتر توضیح نوع پیش‌فرض
value شیء، یا رشتهٔ JSON (گیومهٔ تکی هم پذیرفته می‌شود) string | object الزامی
onError با خطای تجزیه یا سریال‌سازی فراخوانده می‌شود (e: Error) => void کاری نمی‌کند
indent تعداد فاصله در هر تراز number 4

رشتهٔ آراسته را برمی‌گرداند، و اگر ورودی تجزیه‌پذیر نباشد ''.

نمونه

import { formatJson } from 'ranuts';

formatJson({ a: 1, b: [2, 3] });
formatJson("{'a': 1}"); // گیومهٔ تکی پذیرفته می‌شود
formatJson({ a: 1 }, undefined, 2); // تورفتگی دو فاصله
formatJson('nope', (e) => console.warn(e)); // '' برمی‌گردد و خطا به فراخوان می‌رسد

یادداشت‌ها

  1. رشتهٔ ورودی بازتجزیه می‌شود، نه اینکه همان‌طور پس داده شود. اینچنین درستی‌اش وارسی و چیدمانش یکدست می‌شود، به‌جای اعتماد به فاصله‌گذاری فراخواننده.
  2. خطاها گزارش می‌شوند، هرگز پرتاب نمی‌شوند. JSON نامعتبر، ساختارهای چرخه‌ای و مقدارهایی که JSON.stringify نمی‌تواند بنماید، همگی '' برمی‌گردانند و onError را صدا می‌زنند.