InfrastructureLogging

خيارات التسجيل (logging) على مستوى البنية التحتية.

infrastructureLogging.appendOnly

boolean

يُلحق السطور بالمخرَجات بدل تحديث المخرَجات القائمة، وهذا مفيد لرسائل الحالة. ولا يُؤخذ هذا الخيار بعين الاعتبار إلا حين لا تكون قد قدّمت كائن console خاصاً بك.

webpack.config.js

export default {
  // ...
  infrastructureLogging: {
    appendOnly: true,
    level: "verbose",
  },
  plugins: [
    (compiler) => {
      const logger = compiler.getInfrastructureLogger("MyPlugin");
      logger.status("first output"); // لن يُستبدَل هذا السطر طالما أنّ `appendOnly` مُفعَّل
      logger.status("second output");
    },
  ],
};

infrastructureLogging.colors

boolean

يُفعِّل المخرَجات الملوّنة للتسجيل على مستوى البنية التحتية. ولا يُؤخذ بعين الاعتبار إلا حين لا تكون قد قدّمت كائن console خاصاً بك.

webpack.config.js

export default {
  // ...
  infrastructureLogging: {
    colors: true,
    level: "verbose",
  },
  plugins: [
    (compiler) => {
      const logger = compiler.getInfrastructureLogger("MyPlugin");
      logger.log("this output will be colorful");
    },
  ],
};

infrastructureLogging.console

Console

خصِّص كائن الـ console المستخدم في التسجيل على مستوى البنية التحتية.

webpack.config.js

export default {
  // ...
  infrastructureLogging: {
    console: yourCustomConsole(),
  },
};

infrastructureLogging.debug

string boolean = false RegExp function(name) => boolean [string, RegExp, function(name) => boolean]

يُمكّن معلومات التنقيح (debug) لمسجِّلات بعينها كالـ plugins أو الـ loaders. وهو مشابه لخيار stats.loggingDebug لكنه يخصّ البنية التحتية. وقيمته الافتراضية false.

webpack.config.js

export default {
  // ...
  infrastructureLogging: {
    level: "info",
    debug: ["MyPlugin", /MyPlugin/, (name) => name.contains("MyPlugin")],
  },
};

infrastructureLogging.level

string = 'info' : 'none' | 'error' | 'warn' | 'info' | 'log' | 'verbose'

يُفعِّل مخرَجات تسجيل البنية التحتية. شبيه بخيار stats.logging لكنه يخصّ البنية التحتية. وقيمته الافتراضية 'info'.

القيم الممكنة:

• 'none' — تعطيل التسجيل.
• 'error' — الأخطاء فقط.
• 'warn' — الأخطاء والتحذيرات فقط.
• 'info' — الأخطاء والتحذيرات ورسائل المعلومات.
• 'log' — الأخطاء والتحذيرات ورسائل المعلومات ورسائل log والمجموعات وأوامر المسح. وتُعرض المجموعات المطويّة في حالتها المطويّة.
• 'verbose' — تسجيل كل شيء عدا debug و trace. وتُعرض المجموعات المطويّة في حالتها المفتوحة.

webpack.config.js

export default {
  // ...
  infrastructureLogging: {
    level: "info",
  },
};

infrastructureLogging.stream

NodeJS.WritableStream = process.stderr

التيار (stream) المستخدم في مخرَجات التسجيل. القيمة الافتراضية هي process.stderr. ولا يُؤخذ هذا الخيار بعين الاعتبار إلا حين لا تكون قد قدّمت كائن console خاصاً بك.

webpack.config.js

export default {
  // ...
  infrastructureLogging: {
    stream: process.stderr,
  },
};