JSON форматтаушы

JSON деректерін форматтау, тексеру және минификациялау мүмкіндіктері

«JSON форматтаушы» құралы JSON деректерімен жұмыс істеуге арналған кешенді шешім болып табылады. Бұл құралдың көмегімен пайдаланушылар келесі негізгі әрекеттерді орындай алады:

• Форматтау және оқылуды жақсарту: Пайдаланушылар шегініс деңгейін таңдап, деректерді көрнекі түрде реттей алады.
• Минификациялау: Қажетсіз бос орындар мен жол ауысуларын алып тастау арқылы деректер көлемін барынша азайтуға мүмкіндік береді.
• Валидация (Тексеру): Деректердің дұрыстығын тексеріп, қателерді анықтайды және оларды автоматты түрде түзету жолдарын ұсынады.
• Құрылымды зерттеу: Деректерді интерактивті ағаш құрылымы түрінде қарап шығуға, сондай-ақ құжаттың белгілі бір бөліктерін көшіруге немесе нәтижені файл ретінде жүктеп алуға болады.

Құрал үлкен бүтін сандарды ешқандай шығынсыз немесе өзгеріссіз сақтайды. Егер JSON құжатында қайталанған кілттер кездессе, құрал оларды үнсіз біріктіре салмайды немесе жоймайды, керісінше қате ретінде көрсетеді.

Енгізу әдістері және параметрлері

Құралға деректерді енгізудің және өңдеу параметрлерін орнатудың бірнеше жолы бар:

1. Мәтінді тікелей қою: Пайдаланушылар JSON мәтінін арнайы енгізу өрісіне тікелей қоя алады.
2. Файлды жүктеу: «Файлды ашу» батырмасын басу немесе файлды сүйреп апарып тастау арқылы .json немесе .txt файлдарын ашуға болады. Файлдар тек UTF-8 кодтауында болуы тиіс.
3. Синтаксисті таңдау: Пайдаланушылар «Синтаксис» мәзірінен «JSON» және «JSONC» синтаксистерінің бірін таңдай алады.
4. Шегініс деңгейі: Форматтау кезінде қолданылатын шегініс өлшемін таңдау мүмкіндігі бар.
5. Іздеу сұранысы: Ағаш көрінісіндегі деректерді жылдам табу үшін іздеу жолағына мәтін енгізуге болады.

Құралдың жұмыс күйлері мен хабарламалары

Құралмен жұмыс істеу барысында интерфейсте келесі хабарламалар мен күйлер көрсетіледі:

• Бастапқы күйде «Дайын. JSON қойып, әрекетті таңдаңыз.» хабарламасы тұрады.
• Әрекеттер сәтті аяқталғанда «JSON форматталды.», «JSON минификацияланды.» немесе «Редактор тазаланды.» деген мәтіндер шығады.
• Егер өңдеуге ештеңе енгізілмесе, «Алдымен JSON қойыңыз немесе файл ашыңыз.» деген ескерту пайда болады.
• Файл сәтті жүктелгенде «{name} жүктелді ({size}).» хабарламасы, ал нәтижені сақтағанда «{name} жүктеп алынды.» немесе «Алмасу буферіне көшірілді.» деген мәртебелер көрсетіледі.
• Деректердің сипаттамалары ретінде «Таңбалар», «Жолдар» және «Өлшемі» көрсеткіштері есептеліп тұрады.

Деректерді көрсету режимдері және ағаш құрылымы

Пайдаланушылар деректерді екі түрлі режимде көре алады: «Код» (мәтін түрінде) және «Ағаш» (интерактивті құрылым түрінде). «Ағаш» режимінде «JSON ағашы» белгісімен бірге келесі мүмкіндіктер қолжетімді:

• Іздеу жүйесі: «Кілттер мен мәндерді іздеу» жолағы арқылы іздеуге болады. Сәйкестіктер саны «{current} / {total}» немесе шектеуден асқанда «{current} / {total}+» форматында көрсетіледі. Егер ештеңе табылмаса, «Сәйкестік табылмады» деп шығады. Іздеу нәтижелері арасында ауысу үшін «Алдыңғы сәйкестік» және «Келесі сәйкестік» батырмалары қолданылады.
• Түйіндерді басқару: Ағашты толық ашу немесе жабу үшін «Барлығын жаю» және «Барлығын жию» батырмалары бар. Сондай-ақ әрбір элемент үшін жекелей «{key} жаю» және «{key} жию» батырмалары қарастырылған. Ең жоғарғы элемент «түбір» деп белгіленеді.
• Көшіру опциялары: Әрбір кілттің жанында «{key} үшін көшіру опциялары» мәзірі ашылады. Одан «Мәнді көшіру», «JSON Pointer көшіру» немесе «JSONPath көшіру» әрекеттерін таңдауға болады.

Қателерді анықтау және түзету жүйесі

Егер енгізілген JSON жарамсыз болса, құрал «Қате JSON» күйін көрсетіп, «Ағаш түрінде көру үшін JSON қатесін түзетіңіз.» деп ескертеді. Қате табылған орын «{line}-жол, {col}-баған» форматында көрсетіліп, пайдаланушы «Қатеге өту» батырмасы арқылы оған бірден бара алады.

Құрал келесі нақты синтаксистік қателерді анықтайды:

• «Элементтер арасында үтір жоқ»
• «Жабылатын жақшаның алдында артық үтір бар»
• «Объект кілттері қос тырнақшаға алынуы керек»
• «Қасиет атауынан кейін қос нүкте жоқ»
• «Жолдың жабатын тырнақшасы жоқ»
• «JSON тым ерте аяқталады — қиылып қалған сияқты»
• «Мән тұруы керек жерде күтпеген таңба бар»
• «Бұл JSON өңдеу үшін тым терең кірістірілген»
• «Қайталанған кілт {key} — форматтау алдында біреуін жойыңыз»

Егер қате табылса, пайдаланушы «Түзетуді алдын ала қарау» батырмасын баса алады. Бұл кезде «Түзетуді алдын ала қарау» терезесі ашылып, «Түпнұсқа» және «Түзетуден кейін» деген екі нұсқа салыстырылады. Пайдаланушы «Түзетуді қолдану» немесе «Бас тарту» батырмаларын таңдай алады. Түзету сәтті қолданылғанда «Түзету қолданылды. Болдырмау үшін Ctrl/Cmd+Z басыңыз.» хабарламасы шығады. Егер автоматты түзету мүмкін болмаса, «Бұл енгізуді автоматты түрде түзету мүмкін болмады.» деп көрсетіледі.

Стандартты емес форматтарды анықтау және өңдеу

Құрал JSON-ға ұқсас басқа да форматтарды танып, оларды стандартты JSON түріне айналдыруды ұсынады:

• Markdown ішіндегі код: «Бұл Markdown код блогының ішіндегі JSON сияқты.» деп анықталса, «Қолданғанда блок ішіндегі JSON ғана қалады.» әрекеті орындалады.
• Экрандалған жолдар: «Бұл жол ішінде экрандалған JSON сияқты.» жағдайында «Қолданғанда жол экрандаудан шығарылып, қарапайым JSON болады.» әрекеті ұсынылады.
• Python сөздіктері: «Бұл JSON емес, Python стиліндегі сөздік сияқты.» деп танылса, «Қолданғанда тырнақшалар мен True/False/None JSON ретінде қайта жазылады.» әрекеті қолданылады.
• JSON Lines: «Бұл JSON Lines сияқты — әр жолда бір мән.» анықталса, «Қолданғанда жолдар бір JSON жиымына біріктіріледі.» әрекеті жүзеге асады.
• JSONP форматы: «Бұл JSONP callback ішіне оралған JSON сияқты.» болса, «Қолданғанда callback орауышы алынып тасталады.» әрекеті орындалады.
• JSONC форматы: «Бұл JSONC сияқты — түсініктемелер немесе соңғы үтірлер бар. Синтаксисті JSONC-ге ауыстырыңыз немесе түзетуді қолданыңыз.» деп көрсетілсе, «Қолданғанда түсініктемелер мен соңғы үтірлер жойылады.» әрекеті орындалады.

Кез келген жалпы түзетулер үшін «Қолданғанда енгізілген мәтін түзетілген JSON-мен ауыстырылады.» ережесі қолданылады.

Шектеулер мен ерекше жағдайлар

Құралдың қалыпты жұмысын қамтамасыз ету үшін келесі техникалық шектеулер мен ережелер орнатылған:

• Максималды енгізу көлемі: Енгізілетін деректердің ең жоғарғы шегі — 10 MiB. Егер бұл шектен асып кетсе, «Енгізілген мәтін {limit} шамасынан үлкен — бұл құрал өңдей алатыннан көп.» деген хабарлама шығады.
• Файл өлшемінің шектеуі: Жүктелетін файл тым үлкен болса, «Файл тым үлкен — шектеу {limit}.» ескертуі көрсетіледі.
• Қолдау көрсетілмейтін файлдар: Сәйкес келмейтін форматтар үшін «Қолдау көрсетілмейтін файл түрі —.json немесе.txt файлын таңдаңыз.» немесе «Бұл файл UTF-8 мәтіні емес, сондықтан оны мұнда ашу мүмкін емес.» хабарламалары шығады. Оқу сәтсіз аяқталса, «Файлды оқу мүмкін болмады. Оны қайта таңдап көріңіз.» деп көрсетіледі.
• Синхронды өңдеу және уақыт шегі: Синхронды өңдеу шегі 250 000 таңбаны құрайды. Егер тексеру тым ұзаққа созылса, процесс тоқтатылып, «Бұл JSON-ды тексеру тым ұзаққа созылып, тоқтатылды. Кішірек құжатты байқап көріңіз.» деген ескерту шығады.
• Ағаш көрінісінің шектеулері: Егер құжат тым үлкен болса, «Бұл JSON ағаш түрінде көрсету үшін тым үлкен.» немесе «Бұл JSON-да ағаш ретінде көрсету үшін мәндер тым көп.» деген хабарламалар шығады. Ағашты толық жайған кезде шектеуден асып кетсе, «Бұл JSON толық жаю үшін тым үлкен — алғашқы {count} жол көрсетілді.» ескертуі шығып, әрі қарай көру үшін «Тағы {count} көрсету…» батырмасы ұсынылады.
• Кілттерді сұрыптау: «Кілттерді сұрыптау» батырмасы нысан кілттерін кодтық нүкте реті бойынша рекурсивті сұрыптайды, бірақ жиымдардың реті ешқашан өзгермейді. Сұрыптаудан кейін «Кілттерді сұрыптау» батырмасының тұспалды нұсқауында («Нысан кілттерін кодтық нүкте реті бойынша рекурсивті сұрыптайды. Жиымдардың реті ешқашан өзгермейді.») сипатталғандай, «Кілттер сұрыпталды — жиым реті өзгерген жоқ. Болдырмау үшін Ctrl/Cmd+Z басыңыз.» хабарламасы көрсетіледі.
• Қысқартылған алдын ала қарау: Егер түзету бүкіл құжатқа әсер етсе, «Алдын ала қарау қысқартылған — түзету бүкіл құжатқа қатысты.» деген ескерту шығады.

Жиі қойылатын сұрақтар (FAQ)

Менің JSON деректерім серверге жүктеле ме?

Жоқ. Форматтау құралы браузеріңізде жұмыс істейді және JSON деректеріңізді ешқайда жібермейді. JSON браузеріңізде өңделеді және BroBroGo серверіне ештеңе жіберілмейді.

Минификациялау не істейді?

Минификациялау (minify) JSON деректерін сақтай отырып, қажетсіз бос орындар мен жол ауысуларын алып тастайды.