Разбирање на JSON синтаксата и структурата
JSON (JavaScript Object Notation) претставува стандардизиран формат за размена на податоци заснован на текстуален запис. Неговата структура се потпира на два основни концепти: збирки од парови клуч-вредност (објекти) и подредени низи од вредности (низи). Правилната синтакса налага строго дефинирани правила, како што е задолжителното користење на двојни наводници за сите клучеви и текстуални вредности.
Оваа алатка овозможува целосна контрола врз структурата на Вашите податоци, зачувувајќи ги големите цели броеви без никаква загуба на прецизноста при обработката. Дополнително, алатката не дозволува тивко спојување или отфрлање на вредностите при појава на дуплирани клучеви, туку веднаш пријавува грешка за да се спречи несакано губење на податоци.
Важноста на валидацијата и идентификување на грешки
Валидацијата на JSON е критичен чекор при интеграција на системи и развој на API услуги. Неправилно форматираниот JSON може да предизвика прекин во работата на апликациите. Алатката врши детална проверка на синтаксата и при откривање на отстапувања го прикажува статусот „Невалиден JSON“ заедно со точната локација на проблемот во формат „ред {line}, колона {col}“. За брза навигација, на располагање е копчето „Оди до грешката“.
Алатката прецизно ги идентификува следниве чести синтаксички грешки:
- „Недостасува запирка меѓу елементите“
- „Вишок запирка пред затворачката заграда“
- „Клучевите на објектот мора да бидат во двојни наводници“
- „Недостасуваат две точки по името на својството“
- „На низата ѝ недостасува затворачкиот наводник“
- „JSON-от завршува предвреме — изгледа отсечен“
- „Неочекуван знак таму каде што треба да има вредност“
- „Овој JSON е премногу длабоко вгнезден за обработка“
- „Дупликат клуч
{key}— отстранете еден пред форматирање“
Техники за форматирање и минификација
Форматирањето го прави кодот читлив за луѓето преку додавање соодветни празни места и нови редови, додека минификацијата го прави спротивното — ги отстранува сите непотребни знаци за да се намали големината на податоците при пренос или складирање.
При форматирање, корисникот може да го избере саканиот степен за „Ввлекување“ и да избере соодветна синтакса преку опцијата „Синтакса“ (JSON или JSONC). По успешното извршување на операциите, алатката ги прикажува пораките „JSON-от е форматиран.“ или „JSON-от е минифициран.“. Дополнително, достапна е функцијата „Сортирај клучеви“ која рекурзивно ги сортира клучевите на објектите по кодни точки, додека редоследот во низите никогаш не се менува. По оваа операција се прикажува известувањето „Клучевите се сортирани — редоследот на низите е непроменет. Притиснете Ctrl/Cmd+Z за да вратите.“.
Навигација низ сложени податоци со дрвовиден приказ
За анализа на обемни структури, алатката нуди интерактивен приказ „Дрво“ покрај стандардниот приказ „Код“. Овој режим ја прикажува етикетата „JSON дрво“ и нуди поле за пребарување со ознака „Пребарувај клучеви и вредности“. Резултатите од пребарувањето се прикажуваат како „{current} од {total}“ или во лимитирана форма „{current} од {total}+“, а доколку нема совпаѓања се испишува „Нема совпаѓања“. За движење низ резултатите се користат копчињата „Претходно совпаѓање“ и „Следно совпаѓање“.
Дрвото овозможува брза манипулација преку копчињата „Прошири ги сите“ и „Собери ги сите“, како и поединечно управување преку „Прошири {key}“ и „Собери {key}“. За секој јазол е достапно менито „Опции за копирање на {key}“ со следниве можности:
- „Копирај вредност“
- „Копирај JSON Pointer“
- „Копирај JSONPath“
Коренот на структурата секогаш ја носи ознаката „корен“. Доколку внесениот JSON е невалиден, се прикажува пораката „Поправете го JSON-от за да го погледнете како дрво.“.
Работа со нестандардни формати и автоматска поправка
Алатката автоматски детектира неколку специфични нестандардни формати и нуди соодветни решенија за нивна конверзија во чист JSON:
| Детектиран формат | Порака за детекција | Акција за поправка |
|---|---|---|
| Markdown блок | „Ова личи на JSON во коден блок на Markdown.“ | „Со примена останува само JSON содржината во блокот.“ |
| Екраниран стринг | „Ова личи на JSON екраниран во стринг.“ | „Со примена стрингот се отекранира во обичен JSON.“ |
| Python речник | „Ова личи на речник во стил на Python, а не на JSON.“ | „Со примена наводниците и True/False/None се препишуваат како JSON.“ |
| JSON Lines | „Ова личи на JSON Lines — по една вредност во ред.“ | „Со примена редовите се спојуваат во една JSON низа.“ |
| JSONP callback | „Ова личи на JSON завиткан во JSONP callback.“ | „Со примена обвивката на callback-от се отстранува.“ |
| JSONC формат | „Ова личи на JSONC — коментари или завршни запирки. Префрлете ја синтаксата на JSONC или применете ја поправката.“ | „Со примена коментарите и завршните запирки се отстрануваат.“ |
За сите други случаи се користи општата порака „Со примена внесот се заменува со поправениот JSON.“. Корисникот може да го активира прозорецот „Преглед на поправката“ (со ознака „Преглед на поправката“), каде што се споредуваат „Оригинал“ и „По поправката“. Поправката се применува со „Примени ја поправката“ или се прекинува со „Откажи“. По успешното извршување се појавува пораката „Поправката е применета. Притиснете Ctrl/Cmd+Z за да вратите.“, а во спротивно се испишува „Овој внес не може да се поправи автоматски.“. Доколку прегледот е преголем, се појавува предупредувањето „Прегледот е скратен — поправката се однесува на целиот документ.“.
Ограничувања и технички правила за големи датотеки
При обработка на големи документи, алатката применува строги технички ограничувања со цел да се зачува стабилноста на прелистувачот:
- Максимален внес: Алатката поддржува датотеки и внес до најмногу 10 MiB. Доколку се надмине овој лимит, се прикажува пораката „Внесот е поголем од
{limit}, што е повеќе отколку што алатката може да обработи.“. - Временско ограничување: Доколку евалуацијата трае предолго, процесот се прекинува со пораката „Проверката на овој JSON траеше предолго и беше запрена. Обидете се со помал документ.“.
- Синхрона обработка: Прагот за синхрона обработка изнесува 250.000 знаци.
- Ограничувања на дрвото: Доколку податоците се преголеми за визуелизација, се прикажува „Овој JSON е премногу голем за да се прикаже како дрво.“ или „Овој JSON има премногу вредности за приказ како дрво.“. При делумно прикажување, се појавува пораката „Овој JSON е преголем за целосно проширување — прикажани се првите
{count}редови.“ со копче „Прикажи уште{count}…“.
При вчитување датотеки преку „Отвори датотека“ или со влечење во зоната „Пуштете тука.json или.txt датотека“, се применуваат следниве правила:
- Успешно вчитување: „Вчитано:
{name}({size}).“. - Пречекорен лимит: „Датотеката е преголема — ограничувањето е
{limit}.“. - Погрешен формат: „Неподдржан тип на датотека — изберете.json или.txt датотека.“.
- Енкодинг: Датотеките мора да бидат UTF-8. Во спротивно, се појавува пораката „Оваа датотека не е UTF-8 текст, па не може да се отвори тука.“.
- Грешка при читање: „Датотеката не може да се прочита. Обидете се да ја изберете повторно.“.
Локална обработка и приватност
Вашиот JSON се обработува директно во Вашиот прелистувач. Ништо не се испраќа на BroBroGo. Ова овозможува обработката на Вашите податоци да се одвива локално на Вашиот уред.
Често поставувани прашања (FAQ)
Дали се испраќа мојот JSON на сервер?
Не. Форматирањето се извршува локално во Вашиот прелистувач и Вашиот JSON не се испраќа на интернет.
Што прави минификацијата (minify)?
Минификацијата ги отстранува непотребните празни места и преоди во нов ред, додека во целост ги зачувува истите JSON податоци.
Кои формати на датотеки се поддржани за вчитување?
Алатката поддржува исклучиво .json и .txt текстуални датотеки кои се зачувани со UTF-8 кодирање.
Што се случува ако мојот JSON содржи дуплирани клучеви?
Алатката нема автоматски да ги спои или отфрли вредностите, туку ќе пријави синтаксичка грешка за дупликат клуч со цел да се спречи несакано губење на податоци.