הפעם הראשונה ש-Minifying JSON באמת היה חשוב לי לא הייתה באתר - זה היה במיקרו-בקר. שלחתי כתם תצורה למכשיר עם כמה קילובייט של זיכרון פנוי, והגרסה המודפסת היפה שערכתי ביד הייתה כמעט פי שניים מהגודל של אותם נתונים כשהרווח הלבן הוסר. אותם מפתחות, אותם ערכים, אותו מבנה - ההבדל היחיד היה אלפי רווחים וקווים חדשים שהיו קיימים אך ורק כדי שאדם יוכל לקרוא אותם. הסר את אלה והתאמת המטען. זה כל הטריק מאחורי המינימום, והוא חל באותה מידה על תגובת API המוגשת מיליון פעמים ביום כמו על קובץ תצורה שנדחס על שבב.
מדריך זה הוא הגרסה היסודית של איך ולמה למזער JSON, שנבנה סביב החינמי מיניפר JSON כְּלִי. אני אסביר מה המיניפיקציה מסירה ומה היא משאירה לבד בכוונה, מדוע JSON קטן יותר מהיר יותר, עד כמה המיניפיקציה שונה מעיצוב ומבריחה, ותכונה עדינה אחת - דיוק מספרים - שמפרידה בין מיניפר זהיר לרשלני. זה חלק מאותה משפחה כמו ה פורמט JSON אני משתמש לעבודה ההפוכה, והיא שייכת לערכת הכלים שהנחתי ב מדריך אולטימטיבי לכלי JSON.
TL;DR: מזעור JSON מסיר כל רווח, כרטיסייה ושורה חדשה שיושבת בין אסימונים, ומייצר את הטקסט הקטן ביותר שמנתח את אותם נתונים בדיוק. שום דבר על המפתחות, הערכים או הסדר שלהם לא משתנה - רק הרווח הלבן הולך. ה מיניפר JSON מאמת את הקלט שלך תחילה ומדווח על המנתח' שגיאה מדויקת אם היא פגומה, מפשיטה רווח לבן רק מחוץ למילולי מחרוזת כך שהטקסט בתוך הערכים שלך לא ייגע, ושומרת על בתים של אסימונים מספריים עבור בתים כך שערך כמו 1.0 נשאר 1.0. מצב ייפוי הופך את התהליך עם 2 רווחים, 4 רווחים או כרטיסיות. הכל פועל בדפדפן שלך.
מה בעצם עושה minifying JSON?
מסמך JSON הוא רצף של אסימונים - סוגריים, סוגריים, נקודתיים, פסיקים, מחרוזות, מספרים והמילוליים true, false, ו null. בין האסימונים האלה, דקדוק ה-JSON מאפשר כל כמות של רווח לבן, ו-JSON מודפס יפה משתמש בקצבה הזו בנדיבות: שורה חדשה אחרי כל פסיק, שניים או ארבעה רווחים של הזחה לכל רמת קינון, רווח אחרי כל נקודתיים. כל הרווח הלבן הזה קיים לעיניים אנושיות מנתח מתעלם ממנו לחלוטין.
מזעור הוא הפעולה של הסרת כל אחד מאותם תווי רווח לבן חסרי משמעות, תוך השארת רק את האסימונים עצמם ואת הפיסוק המינימלי שהדקדוק דורש. תצורה שקוראת כארבעים שורות מחורצות קורסת לקו צפוף בודד. באופן מכריע, ה נתונים זהה - נתח את הגרסה המוקטנת ואת הגרסה היפה ותקבל את אותו אובייקט בדיוק, עם אותם מפתחות באותו סדר ואותם ערכים. מזעור משנה את הייצוג, לעולם לא את המשמעות הדקדוק שעליו נשען הכל מתפרסם כ RFC 8259, שהיא הסמכות לגבי מה שנחשב לרווח לבן חסר חשיבות ומה לא.
המקום האחד רווח לבן הוא לא חסר חשיבות נמצא בתוך מחרוזת הרווחים פנימה "hello world" הם חלק מהערך וחייבים לשרוד את המיניפיקציה ללא נגיעה. לכן ממיניפר נכון לא יכול פשוט למחוק כל רווח בטקסט; הוא צריך לעקוב אם הוא נמצא בתוך מחרוזת מילולית ולהשאיר את התוכן הזה לבד. ה מיניפר JSON עושה בדיוק את זה, הולך על הטקסט תו אחר תו ורק מפיל רווח לבן שיושב בין אסימונים, כך שרווח מכוון בתוך אחד הערכים שלך לעולם לא יאבד.
למה לטרוח לצמצם את JSON בכלל?
הסיבה לכותרת היא גודל, והגודל מתורגם ישירות למהירות ולעלות באינטרנט. כל בייט של תגובת JSON צריך לעבור דרך הרשת, ועבור מטען שמתבקש אלפי או מיליוני פעמים, הרווח הלבן מצטבר לרוחב פס אמיתי. מעברי הזחה וקו בדרך כלל מהווים חמישית עד שליש ממסמך מודפס יפה ' גודל s, כך שמיניפיקציה יכולה לחתוך פרוסה משמעותית מכל העברה. תגובות קטנות יותר מגיעות מהר יותר, במיוחד בחיבורים ניידים איטיים, והן עולות פחות לשרת כאשר אתה משלם עבור יציאה. זו הסיבה שלמעשה כל API לייצור מחזיר JSON ממוזער וכל כלי בנייה שמאגד נתונים לאפליקציית אינטרנט ממזער אותו תחילה.
יש גם יתרון ניתוח, אם כי הוא קטן יותר. לנתח שלא צריך לדלג על ריצות של רווח לבן יש קצת פחות עבודה לעשות, מה שחשוב בשוליים למסמכים גדולים מאוד שעובדו בלולאה חמה. ויש זווית אחסון שהביאה אותי לכאן מלכתחילה: כשאתה מכניס את JSON לחלל מוגבל - קובץ Cookie עם מגבלת גודל, מכשיר מוטבע, עמודת מסד נתונים עם מכסה, פרמטר שאילתת כתובת URL - הטופס הממוזער הוא מה שהופך אותו מתאים תג חיסכון בגודל בכלי מציג לך את לפני ואחרי בבתים ואת אחוז ההפחתה, כך שתוכל לראות מיד אם מסמך נתון שווה למזער או שכבר היה רזה.
מה שמיניפיקציה עושה לא לקנות אותך זה סודיות או דחיסה במובן של משקל כבד.Minified JSON הוא עדיין טקסט רגיל ועדיין קריא לחלוטין לכל דבר שמנתח אותו; הסרת רווח לבן אינה הצפנה ולא gzip. על החוט, JSON בדרך כלל נדחס gzip על גבי מיניפיקציה, והשניים משלימים - מיניפיקציה מסירה יתירות שהדקדוק מאפשר, ו-gzip מסירה יתירות בזרם הבתים. צמצם מהסיבות למעלה, לא בגלל שאתה חושב שזה מסתיר משהו.
במה שונה מזעור מעיצוב, בריחה ודחיסה?
ארבע הפעולות הללו מתבלבלות ללא הרף, ושמירה עליהן ישרה חוסכת ממך להגיע לכלי הלא נכון. הם פועלים על דברים שונים ופותרים בעיות שונות.
מזעור מסיר רווח לבן לא משמעותי כדי להקטין מסמך תוך שמירה על תוקף JSON. עיצוב, או מייפה, עושה את ההיפך: הוא מוסיף הזחה ושורות כדי להפוך מסמך לקריאה, וזה מה שאתה רוצה כשאתה מאתר באגים בתגובת API או עורך תצורה ביד. ה מיניפר JSON האם שניהם, כי הם שני כיוונים של אותו ציר - minify עבור מכונות, לייפות עבור אנשים. בריחה הוא ציר אחר לגמרי: הוא הופך נתח טקסט לבטוח למקום בתוך מחרוזת JSON על ידי הפיכת ציטוטים ותווי בקרה לרצפי קו נטוי אחורי, וזה התפקיד של JSON Escape / Unescape כֶּלֶב. ו דחיסה כמו gzip פועל על בתים גולמיים מתחת לשכבת JSON, מכווץ את ההעברה עוד יותר לאחר שהמיניפיקציה עשתה את שלה.
הטבלה מפרטת את ההבחנות והנקודות בכלי הנכון עבור כל אחד מהם.
| מבצע | מה זה משנה | התוצאה היא עדיין JSON? | כלי |
|---|---|---|---|
| למזער | מסיר רווח לבן בין אסימונים | כן, אותם נתונים | מיניפר JSON |
| לייפות / פורמט | מוסיף הזחה ומעברי שורות | כן, אותם נתונים | פורמט JSON |
| בריחה | מקודד טקסט לשבת בתוך מחרוזת JSON | זה הופך לערך מחרוזת | JSON Escape / Unescape |
| צמצם CSS | מסיר רווח לבן מגיליון סגנונות | זה CSS, לא JSON | ממיר CSS |
| צמצם HTML | מסיר רווח לבן מהסימון | זה HTML, לא JSON | ממיר HTML |
אותו רעיון minify-for-shipping עובר על פני פורמטים, וזו הסיבה ממיר CSS ו ממיר HTML שב ממש ליד זה - בנייה מלאה מצמצמת את נתוני JSON, גיליון הסגנונות והסימון מאותן סיבות רוחב פס.
האם מזעור JSON משנה אי פעם את הנתונים שלי?
התשובה הנכונה היא שצמצום צריך מעולם לא שנה את הנתונים שלך, וכלי טוב מבטיח זאת אבל יש עדינות שמפרידה בין מיניפר זהיר לבין נאיבי, וכדאי להבין כי הוא יכול לנשוך אותך.
מיני-מכשירים רבים פועלים על-ידי ניתוח ה-JSON לאובייקט בזיכרון ולאחר מכן סדרה מחדש שלו ללא רווח לבן. הנסיעה הלוך ושוב נוחה, אבל זה אומר שכל ערך עובר דרך השפה ' סוג מספר s בדרך, וזה יכול לשכתב את מצב המספרים כתוב למרות שהערך המתמטי לא השתנה ערך שכתבת כ 1.0 חוזר כ 1. ערך כמו 1e3 חוזר כ 1000. מספר שלם עם יותר ספרות מהשפה ' סוג מספר s יכול להחזיק במדויק - כל דבר מעבר לשש עשרה ספרות משמעותיות בערך - יכול לחזור בשינוי עדין. עבור רוב המסמכים שום דבר מזה לא משנה, אבל אם ה-JSON שלך נושא מחרוזות גרסאות, מזהי מסד נתונים או עשרוניות ברמת דיוק קבועה כמספרים, ממיניפר מחדש יכול להשחית אותם בשקט.
ה מיניפר JSON נמנע מהמלכודת על ידי מזעור שונה. זה עדיין מאמת הקלט שלך על ידי ניתוחו, כל כך פגום JSON נתפס ומדווח. אבל כדי להפיק את הפלט הוא מפשיט את הרווח הלבן ישירות מהטקסט המקורי שלך במקום לסדר מחדש אובייקט מנותח, מה שאומר שכל אסימון מספרי נשמר בדיוק כפי שכתבת אותו. אפס נגרר 1.0 נשאר 1.0; מספר שלם בן שלושים ספרות שומר על כל שלושים הספרות. אתה מקבל את הפחתת הגודל של המינימום מבלי להסתכן בשכתוב המספרים שלך - מיטב האימות ונאמנות בתים לביטים. כיוון המייפה, בהיותו על קריאות ולא על תחבורה, אכן מנרמל את העיצוב באמצעות סדרה מחדש סטנדרטית, שהיא ההתנהגות הצפויה כאשר אתה מעצב מחדש לקריאה אנושית.
כיצד אוכל לקרוא את השגיאות כאשר ה-JSON שלי לא יצמצם?
הכלי מאמת לפני שהוא מצטמצם, מה שאומר שמסמך פגום מייצר שגיאה ולא פלט שבור - והשגיאה הזו היא תכונה, לא מכשול. זה אומר לך של-JSON יש בעיה אמיתית לפני אתה שולח אותו למקום שידחה אותו פחות מועיל.
ההודעות מגיעות היישר ממנתח JavaScript JSON ובדרך כלל שמות מיקום הסיבות הנפוצות ביותר הן פסיק נגרר אחרי האלמנט האחרון של מערך או אובייקט, ש-JSON קפדני אוסר עליו; מפתח שאינו עטוף במירכאות כפולות, מכיוון ש-JSON דורש מפתחות מצוטטים בניגוד למילולי אובייקט JavaScript; מחרוזת המשתמשת במירכאות בודדות במקום כפולות; וסוגר או סד לא מאוזן שבו משהו נפתח ולא נסגר. כל אחד מאלה הוא תיקון קטן ברגע שאתה יודע היכן לחפש, והמיקום המדווח מפנה אותך לשכונה. אם המקור שלך הוא למעשה JSONC - JSON עם הערות ופסיקים נגררים, כפי שמשמשים בקבצי תצורה מסוימים - זה לא יצמצם כפי שהוא, כי אלו הרחבות ולא JSON סטנדרטי; הסר תחילה את ההערות והפסיקים הנגררים, או המר ל-JSON קפדני, והוא יאמת.
כאשר המבנה תקף אך אינך יכול לראות למה שני מסמכים מתנהגים אחרת, מייפים את שניהם ומשווים ביניהם, או מעבירים אותם דרך JSON Diff כלי לראות בדיוק אילו מפתחות או ערכים שונים. איתור באגים ב-JSON הוא הרבה יותר קל בצורתו היפה, וזה המקרה היומיומי שעשיתי ב- מדריך JSON Formatter. ומכיוון שכל האימות והמיניפיקציה האלה מתרחשים בדפדפן שלך בלי שום דבר שהועלה, אתה יכול להדביק בבטחה מטענים המכילים מפתחות API, אסימונים או רשומות לקוחות - ארגומנט הפרטיות שציינתי במלואו ב- מדריך פרטיות נתונים לכלים מקוונים.
דוגמה עובדת: מתצורה קריא ועד למטען שנשלח
הנה הנסיעה הלוך ושוב שמראה את הכלי מרוויח את מקומו תגיד שערכת תצורת שירות ביד, אז זה די מודפס לקריאה - מקשי אובייקט בקווים שלהם, הזחה של שני רווחים, מבנה ריק שקל לסרוק לפני שהוא נכנס למשתנה סביבה עם מגבלת אורך, אתה רוצה אותו קטן ככל האפשר.
הדבק את התצורה לתוך מיניפר JSON, לחץ על Minify, והוא קורס לשורה אחת תג הגודל עשוי לקרוא משהו כמו 512 בתים עד 340, הפחתה של שליש, שזה ההבדל בין התאמת המשתנה 's limit ולא.Copy the minified line straight into your environment file.Notice that a timeout you wrote as 1.5 עדיין 1.5 וספירת ניסיון חוזר של 3 עדיין 3 - המספרים אינם נגועים, ואם היה לך מזהה מספרי ארוך הוא היה שורד גם הוא שלם, כי הכלי הפשיט את הרווח הלבן במקום לפרוס מחדש את הערכים.
שבועות לאחר מכן דיווח באג גורם לך לבהות באותו כתם ממוזער ביומן, והוא בלתי קריא בתור שורה אחת צפופה. הדבק אותו בחזרה לתוך הכלי, לחץ על Beautify, בחר שני רווחים, והוא מתרחב לצורה המחורצת שאתה יכול למעשה לסרוק. תקן את הערך, מזער שוב, שלח שוב. הזרימה הדו-כיוונית הזו - ייפוי לקריאה ועריכה, מזעור לאחסון ושליחה - היא הקצב היומי, ושניהם נמצאים במקום אחד עם קריאת גודל ודיווח שגיאות מדויק הוא מה שהופך אותו למהיר. עבור הסט הרחב יותר של כלי עזר לבנייה וספינה זה יושב בין, ה ערכת כלים למפתחי אינטרנט מסגל את השאר.
שאלות נפוצות
כיצד אוכל למזער JSON באינטרנט? הדבק את ה-JSON שלך באזור הקלט ולחץ על Minify. הכלי מסיר את כל ערכי המחרוזת הלבנים מחוץ ומציג את התוצאה הדחוסה יחד עם החיסכון בגודל. הכל פועל בדפדפן שלך, כך ששום דבר לא מועלה.
האם מזעור JSON משנה את הנתונים? מס 'מזעור רק מסיר את הרווח הלבן בין אסימונים, כך המפתחות, הערכים והסדר שלהם להישאר זהה מסמך minified מנתח בדיוק את אותו אובייקט או מערך כמו המקורי מודפס יפה.
למה למזער את JSON בכלל? Minified JSON קטן יותר, כך שהוא מעביר מהר יותר דרך הרשת, משתמש בפחות רוחב פס ומנתח מעט יותר מהר. תגובות API, קבצי תצורה ונתונים המצורפים לאפליקציות אינטרנט מצטמצמים בדרך כלל בייצור מסיבות אלו.
האם הכלי הזה משמר עיצוב מספרים כמו 1.0 או מספרים שלמים גדולים? כן. מכיוון שהוא מפשיט רווחים לבנים במקום מחזר ערכים, אסימונים מספריים נשמרים בדיוק כפי שכתבת אותם. ערך כמו 1.0 נשאר 1.0 ומספר שלם גדול מאוד שומר על כל הספרות שלו, שמקטע ניתוח והחזרה ישכתב.
מה ההבדל בין מזעור לייפות JSON? מזעור מסיר רווח לבן כדי להפוך את JSON לקטן ככל האפשר עבור מכונות, בעוד מייפות מוסיף הזחה ומעברי שורות כדי להפוך אותו לקריאה עבור אנשים כלי זה עושה את שניהם: מזעור למשלוח, מייפה לעריכה וניפוי באגים.
האם זה יכול למזער JSON עם הערות או פסיקים נגררים? מס 'תקן JSON אינו מאפשר הערות או פסיקים נגררים, ולכן הכלי מדווח על אלה כשגיאות במהלך אימות. הסר הערות ופסיקים נגררים תחילה, או המר את ה-JSONC שלך ל-JSON קפדני, ולאחר מכן צמצם.
האם זה בטוח למזער JSON רגיש כאן? כן כל העיבוד מתרחש ב-JavaScript בתוך הדפדפן שלך, כך שאף JSON לא נשלח לשום שרת, שום דבר לא נרשם, והכלי עובד כשהחיבור שלך מושבת. אתה יכול למזער בבטחה מטענים המכילים מפתחות API או נתונים אישיים.
מדוע ה-JSON שלי מראה שגיאה במקום למזער? הכלי מאמת את הקלט שלך לפני הקטנה, כך ששגיאה פירושה שה-JSON פגום, בדרך כלל פסיק חסר או נוסף, מפתח לא מצוטט, מחרוזת עם ציטוט בודד או סוגר לא מאוזן ההודעה כוללת את מיקום הבעיה כדי שתוכל לתקן את זה.
מדריך זה מלווה את החינם מיניפר JSON כלי על Toolz.dev - אין הרשמה, אין העלאות, עובד במצב לא מקוון.
