افزونه نگاشت منبع ignoreList

با افزونه نقشه منبع ignoreList، تجربه اشکال‌زدایی را در Chrome DevTools بهبود دهید.

‫Chrome DevTools فیلد ignoreList را در نقشه‌های منبع تجزیه می‌کند تا به بهبود تجربه اشکال‌زدایی توسعه‌دهنده کمک کند. به ردیابی پشته زیر در کنسول نگاه کنید. DevTools به‌طور خودکار همه فریم‌های شخص ثالث را پنهان می‌کند و فقط فریم‌های مرتبط با کد شما را نشان می‌دهد.

مقایسه نتایج ردیابی پشته‌ای.
تصویر ردیابی‌های پشته را قبل و بعداز پشتیبانی Chrome DevTools از ignoreList نشان می‌دهد. مورد دوم قاب‌های طرف سوم نامربوط را پنهان می‌کند تا به شما کمک کند مشکلات را درطول اشکال‌زدایی سریع‌تر شناسایی کنید.

ignoreList چیست؟

افزونه‌های نقشه‌های منبع فیلدهای اضافی هستند که اطلاعات تکمیلی درباره نقشه منبع را ذخیره می‌کنند. این فیلدها با x_ پیشوندگذاری شده‌اند.

Chrome DevTools از فیلد ignoreList (درصورت ارائه) برای فیلتر کردن کد تولیدشده استفاده می‌کند و به توسعه‌دهندگان وب اجازه می‌دهد فقط روی کدی که خودشان نوشته‌اند تمرکز کنند. برای مثال، به نقشه منبع زیر نگاه کنید.

/* demo.js.map */

{
  "version": 3,
  "mappings": "AAAAA, ..."
  "sources": [
    "app.js",
    "components/Button.ts",
    "node_modules/.../framework.js",
    "node_modules/.../library.js",
    ...
  ],
  "ignoreList": [2, 3],
  ...
}

فیلد sources فهرستی از منابع اصلی استفاده‌شده توسط ورودی mappings را نشان می‌دهد. برای آشنایی با نحوه عملکرد نگاشت‌ها، نقشه‌های منبع چیست؟ را تماشا کنید.

باتوجه‌به اینکه دو فایل node_modules/…/frameworks.js و node_modules/.../library.js اسکریپت‌های شخص ثالث هستند، می‌توانید فیلد ignoreList را برای نشان دادن موقعیت آن‌ها در فیلد sources مشخص کنید. ‫Chrome DevTools از این اطلاعات برای پنهان کردن قاب‌های آن فایل‌های نادیده‌گرفته‌شده استفاده خواهد کرد.

مقایسه رد پشته جمع‌شده و ازهم بازشده.
تصویر رد پشته را قبل و بعداز ازهم باز کردن رد پشته در «کنسول» نشان می‌دهد. قاب‌های نادیده‌گرفته‌شده هنگام ازهم باز شدن خاکستری می‌شوند.

این موضوع برای پشته فراخوانی در پانل منابع درطول اشکال‌زدایی نقطه توقف نیز صدق می‌کند.

در پشت صحنه، DevTools تنظیمات اضافه‌ای دارد که به‌طور پیش‌فرض فعال است: متن‌های اشخاص ثالث آشنا به‌طور خودکار به فهرست استثناها اضافه می‌شوند. می‌توانید آن را در DevTools > تنظیمات > فهرست نادیده‌گرفتن پیدا کنید.

با فیلد نگاشت منبع ignoreList، این گزینه را دارید که فایل‌های نادیده‌گرفته‌شده را در پانل منابع پنهان کنید تا روی کدتان تمرکز کنید.

پنهان کردن منابع موجود در فهرست نادیده گرفتن.

نحوه پر کردن ignoreList

خبر خوب این است که چارچوب‌هایی مثل Angular و Nuxt ازقبل ignoreList را در نقشه‌های منبع خود پیکربندی می‌کنند. به جدیدترین نسخه ارتقا دهید تا بدون نیاز به پیکربندی کار کند. به‌راحتی می‌توانید ردیابی پشته را بهبود دهید.

ازسوی‌دیگر، ابزارهای ساخت مانند Vite و Rollup تنظیماتی را برای پیکربندی آن ارائه می‌دهند. افزونه webpack هم برای آن وجود دارد.

اگر نگهدارنده چارچوب یا کتابخانه هستید، ضروری است که بدانید چگونه این تنظیمات را برای بهبود تجربه اشکال‌زدایی کاربران خود پیاده‌سازی کنید. بخش زیر را ببینید تا متوجه شوید Angular و Nuxt چگونه این کار را در پشت صحنه انجام دادند.

اگر چارچوب و ابزار ساخت موردعلاقه‌تان هنوز از آن پشتیبانی نمی‌کند، چه؟

ما به‌طور فعال با چارچوب‌ها کار می‌کنیم و ابزارهایی برای پیاده‌سازی این تنظیمات جدید می‌سازیم. همچنین می‌توانید با مطلع کردن نگهدارندگان از این ویژگی کمک کنید. برای مثال، می‌توانید مشکلی را در مخزن آن‌ها ثبت کنید.

یا می‌توانید به‌طور دستی اسکریپت‌های نامربوط را به «فهرست نادیده‌گرفته‌ها» اضافه کنید، درست از درخت فایل در DevTools > منابع > صفحه تا به نتیجه مشابهی برسید.

مطالعات موردی: پیاده‌سازی Nuxt و Angular

به دو مطالعه موردی زیر نگاهی بیندازید.

‫ignoreList در Nuxt

از Nuxt نسخه ۳.۳.۱، محتوای node_modules و Nuxt buildDir به‌عنوان «مواردی که اشکال‌زداها باید نادیده بگیرند» علامت‌گذاری شده‌اند.

این امر ازطریق تغییر در پیکربندی ساخت Nuxt بااستفاده از Vite و Rollup حاصل شد:

/* vite.config.ts */

const ctx: ViteBuildContext = {
  config: vite.mergeConfig(
  build: {
    rollupOptions: {
      output: {
        sourcemapIgnoreList: (relativeSourcePath) => {
          return relativeSourcePath.includes('/node_modules/') || relativeSourcePath.includes(ctx.nuxt.options.buildDir)
        },
      }
})

تیم DevTools مایل است از تیم‌های Vite و Nuxt برای ممکن ساختن این امر قدردانی کند. از تلاش‌ها و همکاری شما که برای موفقیت این پیاده‌سازی ضروری بود قدردانی می‌کنیم. بازهم از تیم‌های Vite و Nuxt بابت همیاری‌هایشان سپاس‌گزاریم!

‫ignoreList در Angular

از Angular نسخه ۱۴.۱.۰، محتوای پوشه‌های node_modules و webpack به‌عنوان «نادیده گرفته شود» علامت‌گذاری شده است.

این کار ازطریق تغییر در angular-cli با ایجاد افزونه‌ای که به ماژول Compiler webpack متصل می‌شود انجام شد.

افزونه webpack که مهندسان ما ایجاد کرده‌اند به مرحله PROCESS_ASSETS_STAGE_DEV_TOOLING متصل می‌شود و فیلد ignoreList را در نقشه‌های منبع با دارایی‌های نهایی که webpack تولید می‌کند و مرورگر بار می‌کند پر می‌کند.

const map = JSON.parse(mapContent) as SourceMap;
const ignoreList = [];

for (const [index, path] of map.sources.entries()) {
  if (path.includes('/node_modules/') || path.startsWith('webpack/')) {
    ignoreList.push(index);
  }
}

map[`ignoreList`] = ignoreList;
compilation.updateAsset(name, new RawSource(JSON.stringify(map)));

برای کسب اطلاعات بیشتر درباره سایر بهبودهای اشکال‌زدایی Angular در DevTools، به مطالعه موردی: اشکال‌زدایی بهتر Angular با DevTools مراجعه کنید.

تیم Chrome DevTools مایل است از تیم Angular به‌خاطر مشارکت‌های ارزشمندشان در موفقیت این پیاده‌سازی قدردانی کند. تلاش‌ها و همکاری شما ضروری بود و از زحمات شما قدردانی می‌کنیم. از تیم Angular برای ممکن کردن این امر سپاس‌گزاریم!