דילוג לתוכן
  • דף הבית
  • קטגוריות
  • פוסטים אחרונים
  • משתמשים
  • חיפוש
  • חוקי הפורום
כיווץ
תחומים

תחומים - פורום חרדי מקצועי

💡 רוצה לזכור קריאת שמע בזמן? לחץ כאן!
  1. דף הבית
  2. תכנות
  3. שיתוף - קבלת שגיאות טייפים על JSDoc (בלי לעבור לTypeScript!)

שיתוף - קבלת שגיאות טייפים על JSDoc (בלי לעבור לTypeScript!)

מתוזמן נעוץ נעול הועבר תכנות
3 פוסטים 1 כותבים 166 צפיות
  • מהישן לחדש
  • מהחדש לישן
  • הכי הרבה הצבעות
התחברו כדי לפרסם תגובה
נושא זה נמחק. רק משתמשים עם הרשאות מתאימות יוכלו לצפות בו.
  • צדיק תמיםצ מנותק
    צדיק תמיםצ מנותק
    צדיק תמים
    כתב ב נערך לאחרונה על ידי
    #1

    JSDoc מאפשרת לקבל רמזי טייפ בעורך קוד על הטייפים שמקבלת ומחזירה כל פונקציה בריחוף על הפונקציה או על קריאה אליה.

    אבל אפשר גם לקבל ממש משוב על חריגות מהטייפ שהוגדר!
    ובלי התקורה של כתיבה בTS והגדרת טייפים מדוקדקים...
    איך? פשוט מוסיפים בתקיה קובץ tsconfig.json, ומקבלים סימון אדום על כל חריגה מהטייפ שהוגדר:
    CleanShot 2023-09-13 at 02.19.15@2x.png

    גיליתי את האפשרות בזכות: https://www.tocode.co.il/blog/2023-09-jsdoc

    Don’t comment bad code — rewrite it." — Brian W. Kernighan and P. J. Plaugher"
    טיפים

    תגובה 1 תגובה אחרונה
    5
    • צדיק תמיםצ מנותק
      צדיק תמיםצ מנותק
      צדיק תמים
      כתב ב נערך לאחרונה על ידי צדיק תמים
      #2

      ייבוא טייפ בתוך JSDoc של פונקציה (גם כאשר הקוד עצמו משתמש בrequire/exports) - בדוגמה כדי לציין שהפונקציה מחזירה פרומיס שנפתר עם AxiosResponse:

      /**
       * Example function.
       *
       * @return {Promise<import('axios').AxiosResponse>} The response from the upload request.
       */
      function getData () {
          return axios.get('/api');
      }
      

      כאן אם לא נגדיר במפורש @return המנוע מזהה לבד את הטייפ, אבל אם מגדירים במפורש כדי להוסיף תיאור, צריך להגדיר את הטייפ, וכן עבור מקרים נוספים זה שימושי.

      Don’t comment bad code — rewrite it." — Brian W. Kernighan and P. J. Plaugher"
      טיפים

      תגובה 1 תגובה אחרונה
      3
      • צדיק תמיםצ מנותק
        צדיק תמיםצ מנותק
        צדיק תמים
        כתב ב נערך לאחרונה על ידי צדיק תמים
        #3

        כאנקדוטה יש לציין שהפריימוורק Svelte עובר להשתמש בJSDoc לצורך אכיפת סוגים במקום TS רגיל, כדי להיפטר מהצורך בקומפילציה (אחרי שעשו את זה ב-sveltekit כבר לפני שנה+)
        https://news.ycombinator.com/item?id=35892250
        https://github.com/sveltejs/svelte/pull/8569

        Don’t comment bad code — rewrite it." — Brian W. Kernighan and P. J. Plaugher"
        טיפים

        תגובה 1 תגובה אחרונה
        2

        בא תתחבר לדף היומי!
        • התחברות

        • אין לך חשבון עדיין? הרשמה

        • התחברו או הירשמו כדי לחפש.
        • פוסט ראשון
          פוסט אחרון
        0
        • דף הבית
        • קטגוריות
        • פוסטים אחרונים
        • משתמשים
        • חיפוש
        • חוקי הפורום