የJSON ፎርማተር ዋና ተግባራት
የJSON ፎርማተር የJSON ውሂብን ለመቅረጽ፣ ለማረጋገጥ እና ለማሳነስ የሚያገለግል መሣሪያ ነው። ይህ መሣሪያ ተጠቃሚዎች የJSON ጽሑፍን በቀጥታ እንዲለጥፉ ወይም የJSON ፋይሎችን እንዲከፍቱ ያስችላቸዋል። ከዚያም በተለያዩ የማስገቢያ (Indentation) ደረጃዎች መቅረጽ፣ አላስፈላጊ ቁምፊዎችን ለማስወገድ ማሳነስ (minify) ወይም ቁልፎችን መደርደር የመሰሉ ተግባራትን ማከናወን ይቻላል።
በተጨማሪም የJSON መዋቅርን ለመመርመር የሚያስችል የዛፍ (Tree) ዕይታ ያቀርባል። ከተቀነባበረው ውሂብ ላይ የተወሰኑ ክፍሎችን ለመቅዳት ወይም ውጤቱን ለማውረድ የሚያስችሉ አማራጮችም አሉት። መሣሪያው በJSON ውሂብ ውስጥ ያሉ ስህተቶችን ጎልተው እንዲታዩ በማድረግ እና የጥገና ሃሳቦችን በማቅረብ ተጠቃሚዎች ችግሮችን ለይተው እንዲያስተካክሉ ይረዳል።
ወደ መሣሪያው የሚገቡ ግብዓቶች
ይህ መሣሪያ የሚከተሉትን የግብዓት አይነቶች እና ቅንብሮች ይቀበላል፦
- የተለጠፈ JSON፦ ተጠቃሚዎች የJSON ጽሑፍን በቀጥታ በግብዓት ቦታው ላይ መለጠፍ ይችላሉ።
- ፋይል መጫን፦ ተጠቃሚዎች "ፋይል ክፈት" የሚለውን በመጫን ወይም ፋይሉን ጎትቶ በመጣል
.jsonወይም.txtፋይል መክፈት ይችላሉ።- የፋይል መጠን ገደብ፦ ከተወሰነው ገደብ በላይ የሆኑ ፋይሎችን መክፈት አይቻልም።
- የፋይል አይነት፦ የሚደገፉት
.jsonወይም.txtፋይሎች ብቻ ናቸው። - የፊደል ኢንኮዲንግ (Encoding)፦ ፋይሎች የግድ በUTF-8 ኢንኮዲንግ የተጻፉ መሆን አለባቸው።
- የማስገቢያ (Indentation) ደረጃ፦ ተጠቃሚዎች ለመቅረጽ የሚፈልጉትን የማስገቢያ ደረጃ መምረጥ ይችላሉ።
- የአገባብ ምርጫ፦ ተጠቃሚዎች በ"JSON" እና "JSONC" አገባብ መካከል መምረጥ ይችላሉ።
- የፍለጋ ጽሑፍ፦ በዛፍ (Tree) ዕይታ ውስጥ ባለው የፍለጋ ሳጥን ውስጥ ተጠቃሚዎች መፈለጊያ ጽሑፍ መተየብ ይችላሉ።
ከመሣሪያው የሚወጡ ውጤቶች እና መልዕክቶች
መሣሪያው እንደየሁኔታው የሚከተሉትን ውጤቶች፣ የሁኔታ መግለጫዎች እና የስህተት መልዕክቶች ያሳያል፦
የሁኔታ እና የውጤት መግለጫዎች
- የተቀረጸ JSON፦ የJSON ይዘት በተመረጠው የማስገቢያ ደረጃ መሰረት በኮድ ዕይታ ውስጥ ይታያል።
- የቀነሰ (Minified) JSON፦ አላስፈላጊ ክፍተቶች እና የመስመር መቋረጦች የተወገዱለት የJSON ይዘት።
- "ዝግጁ። JSON ይለጥፉ እና ድርጊት ይምረጡ።"
- "JSON ተቀርጿል።"
- "JSON ተቀንሷል (minified)።"
- "ማስተካከያው ጽድቷል።"
- "ትክክለኛ JSON"
- "ልክ ያልሆነ JSON"
- "ቁምፊዎች"፣ "መስመሮች" እና "መጠን"፦ የገቡትን የቁምፊዎች ብዛት፣ የመስመሮች ብዛት እና የግብዓቱን መጠን የሚያሳዩ ስታቲስቲክስ።
- "ኮድ" ዕይታ፦ የJSON ውሂቡን በጽሑፍ መልክ ያሳያል።
- "ዛፍ (Tree)" ዕይታ፦ የJSON ውሂቡን በይነተገናኝ በሆነ የዛፍ መዋቅር ያሳያል።
የፋይል እና የግብዓት ስህተቶች
- "ፋይሉ በጣም ትልቅ ነው — ገደቡ
{limit}ነው።" - "የማይደገፍ የፋይል አይነት —.json ወይም.txt ፋይል ይምረጡ።"
- "ይህ ፋይል የUTF-8 ጽሑፍ አይደለም፣ ስለዚህ እዚህ ሊከፈት አይችልም።"
- "ይህን ፋይል ማንበብ አልተቻለም። እንደገና መርጠው ይሞክሩ።"
- "ግብዓቱ ከ
{limit}በላይ ነው፣ ይህም ይህ መሣሪያ ማስኬድ ከሚችለው በላይ ነው።" - "ይህን JSON መፈተሽ በጣም ረጅም ጊዜ ወስዶ ተቋርጧል። አነስ ያለ ሰነድ ይሞክሩ።"
- "መጀመሪያ የተወሰኑ JSON ይለጥፉ ወይም ይክፈቱ።"
- "
{name}ተጭኗል።" እና "{name}ወርዷል።" - "ወደ ቅንጥብ ሰሌዳ ተገልብጧል።"
የJSON አገባብ ስህተቶች እና መገኛቸው
የገባው JSON ልክ ካልሆነ መሣሪያው የስህተቱን መገኛ በ**"መስመር {line}፣ አምድ {col}"** መልክ ያሳያል። ተጠቃሚው "ወደ ስህተቱ ሂድ" የሚለውን ቁልፍ በመጫን በቀጥታ ወደ ስህተቱ ቦታ መሄድ ይችላል። የሚታዩት የአገባብ ስህተቶች የሚከተሉት ናቸው፦
- "በንጥሎች መካከል ኮማ ጎድሏል"
- "ከመዝጊያው ቅንፍ በፊት ተጨማሪ ኮማ አለ"
- "የነገር ቁልፎች በድርብ ጥቅሶች መከበብ አለባቸው"
- "ከንብረት ስም በኋላ ኮለን ጎድሏል"
- "አንድ ሕብረቁምፊ የመዝጊያ ጥቅሱ ጎድሎታል"
- "JSONው ቀድሞ ያበቃል — የተቆረጠ ይመስላል"
- "እሴት መሆን በሚገባው ቦታ ያልተጠበቀ ቁምፊ አለ"
- "ይህ JSON ለማስኬድ በጣም ጥልቅ ሆኖ ተደራርቧል"
- "የተደጋገመ ቁልፍ
{key}— ከመቅረጹ በፊት አንዱን ያስወግዱ"
የዛፍ (Tree) ዕይታ አጠቃቀም እና ገደቦች
የዛፍ ዕይታ የJSON ውሂብን በ**"የJSON ዛፍ"** መለያ ስር በይነተገናኝ በሆነ መዋቅር ያሳያል። የዛፉ መዋቅር መጀመሪያ የሚጀምረው ከ**"ስር"** መለያ ነው።
የዛፍ ዕይታ ፍለጋ እና ቁጥጥር
- "ቁልፎችን እና እሴቶችን ይፈልጉ" በሚለው ሳጥን ውስጥ በመተየብ መፈለግ ይቻላል።
- የፍለጋ ውጤቶች በ**"
{current}ከ{total}"** ወይም ውጤቱ ከተገደበ በ**"{current}ከ{total}+"** መልክ ይታያሉ። ምንም ተዛማጅ ከሌለ "ምንም ተዛማጅ የለም" ይላል። - ተጠቃሚዎች በ**"ቀዳሚ ተዛማጅ"** እና "ቀጣይ ተዛማጅ" ቁልፎች ፍለጋቸውን ማሰስ ይችላሉ።
- ዛፉን ሙሉ በሙሉ ለመቆጣጠር "ሁሉንም ዘርጋ" እና "ሁሉንም ሰብስብ" ቁልፎች አሉ።
- ለእያንዳንዱ ንጥል "
{key}ን ዘርጋ" እና "{key}ን ሰብስብ" የሚሉ ቁልፎች ይገኛሉ። - በተጨማሪም ለተወሰኑ ቁልፎች "ለ
{key}የመቅዳት አማራጮች" የሚል ዝርዝር ይኖራል። ከዚህ ውስጥ "እሴቱን ቅዳ"፣ "JSON Pointerን ቅዳ" ወይም "JSONPathን ቅዳ" የሚሉትን መምረጥ ይቻላል።
የዛፍ ዕይታ ገደቦች
- የገባው JSON ልክ ካልሆነ ዛፉ አይሰራም፤ ይልቁንም "እንደ ዛፍ (tree) ለማየት JSONን ያስተካክሉ።" የሚል መልዕክት ያሳያል።
- JSONው በጣም ትልቅ ከሆነ "ይህ JSON እንደ ዛፍ (tree) ለመታየት በጣም ትልቅ ነው።" ወይም "ይህ JSON እንደ ዛፍ (tree) ለመታየት በጣም ብዙ እሴቶች አሉት።" የሚል መልዕክት ይወጣል።
- በትልቅ JSON ላይ ሁሉንም ለመዘርጋት ሲሞከር "ይህ JSON ሙሉ በሙሉ ለመዘርጋት በጣም ትልቅ ነው — የመጀመሪያዎቹ
{count}ረድፎች እየታዩ ነው።" የሚል ገደብ ይኖረዋል። ተጠቃሚው "{count}ተጨማሪ አሳይ…" የሚለውን ቁልፍ በመጫን ተጨማሪ ረድፎችን ማየት ይችላል።
ቁልፎችን መደርደር እና ስህተቶችን በራስ-ሰር ማስተካከል
መሣሪያው የJSON ውሂብን ለማስተካከል እና ለመደርደር ተጨማሪ አማራጮችን ይሰጣል፦
ቁልፎችን መደርደር
ተጠቃሚዎች "ቁልፎችን ደርድር" የሚለውን ቁልፍ በመጫን የነገር ቁልፎችን በኮድ-ነጥብ ቅደም ተከተል በተደጋጋሚ መደርደር ይችላሉ። ይህ ተግባር የአደራደር (array) ቅደም ተከተልን በጭራሽ አይቀይርም። ቁልፎቹ ከተደረደሩ በኋላ "ቁልፎቹ ተደርድረዋል — የአደራደሩ ቅደም ተከተል አልተቀየረም። ለመቀልበስ Ctrl/Cmd+Z ይጫኑ።" የሚል ማሳሰቢያ ይታያል።
የጥገና ቅድመ-እይታ እና አተገባበር
ስህተት ያለበት JSON ሲገባ "ጥገናውን ቀድመው ይመልከቱ" የሚለውን ቁልፍ በመጫን "የጥገና ቅድመ-እይታ" መክፈት ይቻላል። በዚህ ዕይታ ውስጥ "ዋናው" እና "ከጥገናው በኋላ" የሚሉ መለያዎች ጎን ለጎን ይታያሉ።
- ጥገናውን ለመተግበር "ጥገናውን ተግብር" የሚለውን፣ ለመተው ደግሞ "ሰርዝ" የሚለውን መጫን ይቻላል።
- ጥገናው ከተተገበረ በኋላ "ጥገናው ተተግብሯል። ለመቀልበስ Ctrl/Cmd+Z ይጫኑ።" የሚል መልዕክት ይወጣል።
- ግብዓቱ በራስ-ሰር ሊስተካከል የማይችል ከሆነ "ይህ ግቤት በራስ-ሰር ሊስተካከል አልቻለም።" ይላል።
- የጥገና ቅድመ-እይታው ከተቆረጠ "ቅድመ-እይታው ተቆርጧል — ጥገናው መላውን ሰነድ ይመለከታል።" የሚል ማስጠንቀቂያ ይታያል።
መደበኛ ያልሆኑ የJSON ቅርጸቶችን መለየት
መሣሪያው መደበኛ ያልሆኑ የJSON ቅርጸቶችን በራስ-ሰር መለየት ይችላል። ቅርጸቶቹ ሲገኙ የሚከተሉት የመለያ መልዕክቶች እና የጥገና ተግባራት ይቀርባሉ፦
- Markdown ኮድ አጥር፦ "ይህ በ Markdown የኮድ አጥር ውስጥ ያለ JSON ይመስላል።" የሚል መልዕክት ሲያሳይ፣ ሲተገበር በአጥሩ ውስጥ ያለው JSON ብቻ ይቀራል።
- Escape የተደረገ JSON፦ "ይህ በሕብረቁምፊ ውስጥ escape የተደረገ JSON ይመስላል።" የሚል መልዕክት ሲያሳይ፣ ሲተገበር ሕብረቁምፊው unescape ተደርጎ ተራ JSON ይሆናል።
- Python መዝገበ-ቃላት፦ "ይህ JSON ሳይሆን የ Python ዓይነት መዝገበ-ቃላት ይመስላል።" የሚል መልዕክት ሲያሳይ፣ ሲተገበር የጥቅስ ምልክቶች እና True/False/None እንደ JSON እንደገና ይጻፋሉ።
- JSON Lines፦ "ይህ JSON Lines ይመስላል — በአንድ መስመር አንድ እሴት።" የሚል መልዕክት ሲያሳይ፣ ሲተገበር መስመሮቹ ወደ አንድ JSON አደራደር ይሰበሰባሉ።
- JSONP Callback፦ "ይህ በ JSONP callback የተጠቀለለ JSON ይመስላል።" የሚል መልዕክት ሲያሳይ፣ ሲተገበር የ callback መጠቅለያው ይወገዳል።
- JSONC ቅርጸት፦ "ይህ JSONC ይመስላል — አስተያየቶች ወይም የመጨረሻ ኮማዎች አሉ። አገባቡን ወደ JSONC ይቀይሩ ወይም ጥገናውን ይተግብሩ።" የሚል መልዕክት ያሳያል። "አገባብ" የሚለውን መለያ በመጠቀም ወደ JSONC መቀየር ወይም ጥገናውን በመተግበር አስተያየቶችን እና የመጨረሻ ኮማዎችን ማስወገድ ይቻላል።
- ለሌሎች አጠቃላይ ጥገናዎች "ሲተገበር ግቤቱ በተስተካከለው JSON ይተካል።" የሚል መመሪያ ይሰጣል።
የቴክኒክ ደንቦች እና የደህንነት መረጃዎች
ይህ መሣሪያ ትክክለኛነትን እና ደህንነትን ለመጠበቅ የሚከተሉትን ደንቦች ይከተላል፦
- ትላልቅ ኢንቲጀሮች፦ መሣሪያው ትላልቅ ኢንቲጀሮችን (large integers) ያለምንም መጥፋት ወይም መበላሸት በጥንቃቄ ይይዛል።
- የተደጋገሙ ቁልፎች፦ በJSON ውሂብ ውስጥ የተደጋገሙ ቁልፎች ካሉ፣ መሣሪያው ውሂቡን በዝምታ ከመቀላቀል ወይም ከመጣል ይልቅ የስህተት መልዕክት ያሳያል።
- የማስኬጃ ገደቦች፦
- የማመሳሰል (synchronous) ሂደት ገደብ 250,000 ቁምፊዎች ነው።
- ከፍተኛው የግብዓት መጠን 10 MiB ነው።
- የግል ደህንነት፦ የእርስዎ JSON የሚቀነባበረው በራስዎ ብሮውዘር ውስጥ ብቻ ነው። ወደ BroBroGo ምንም ዓይነት ውሂብ አይሰቀልም።
ተደጋግሞ የሚነሱ ጥያቄዎች (FAQ)
የእኔ JSON ይሰቀላል?
አይደለም። ፎርማተሩ በብሮውዘርዎ ውስጥ ነው የሚሰራው እና የእርስዎን JSON አይሰቅልም።