مرجع واجهة برمجة تطبيقات Console

استخدِم Console API لكتابة الرسائل إلى وحدة التحكّم من JavaScript. راجع بدء تسجيل الرسائل في وحدة التحكم للحصول على مقدمة تفاعلية حول الموضوع.

يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات لأدوات تسهيل الاستخدام Console إذا كنت تبحث عن طرق تنفيذ مثل debug(function) أو monitorEvents(node) التي لا تتوفّر إلا من خلال وحدة التحكّم.

console.assert(expression, object)

مستوى السجلّ: Error

كتابة خطأ في وحدة التحكم عند تقييم expression إلى false.

const x = 5;
const y = 3;
const reason = 'x is expected to be less than y';
console.assert(x < y, {x, y, reason});

نتيجة مثال console.assert() أعلاه.

console.clear()

محو وحدة التحكّم.

console.clear();

في حال تفعيل Preserve Log، سيتم إيقاف console.clear().

بدلاً من ذلك، يمكنك محو وحدة التحكّم من خلال النقر على رمز ALT_TEXT_HERE.

console.count([label])

مستوى السجلّ: Info

اكتب عدد مرات استدعاء الدالة count() في السطر نفسه وبسمة label نفسها. يمكنك الاتصال بالرقم console.countReset([label]) لإعادة ضبط العدّ.

console.count();
console.count('coffee');
console.count();
console.count();

نتيجة مثال console.count() أعلاه.

console.countReset([label])

إعادة ضبط عدد.

console.countReset();
console.countReset('coffee');

console.createTask(name)

تعرض مثيل Task يربط تتبُّع تسلسل استدعاء الدوال البرمجية الحالي بالكائن task الذي تم إنشاؤه. يمكنك لاحقًا استخدام كائن task هذا لتشغيل دالة (f في المثال التالي). ينفذ task.run(f) حمولة عشوائية ويعيد توجيه القيمة المعروضة إلى المتصل.

// Task creation
const task = console.createTask(name);

// Task execution
task.run(f); // instead of f();

ويشكّل task رابطًا بين سياق الإنشاء وسياق الدالة غير المتزامنة. يتيح هذا الرابط لـ "أدوات مطوّري البرامج" عرض عمليات تتبُّع أفضل لتسلسل استدعاء الدوال البرمجية للعمليات غير المتزامنة. لمزيد من المعلومات، يُرجى الاطّلاع على تتبُّع تسلسل استدعاء الدوال البرمجية.

console.debug(object [, object, ...])

مستوى السجلّ: Verbose

يتطابق مع console.log(object [, object, ...]) باستثناء مستوى السجلّ الآخر.

console.debug('debug');

نتيجة مثال console.debug() أعلاه.

console.dir(object)

مستوى السجلّ: Info

يطبع تمثيل JSON للكائن المحدد.

console.dir(document.head);

نتيجة مثال console.dir() أعلاه.

console.dirxml(node)

مستوى السجلّ: Info

يطبع تمثيل XML الخاص بالعناصر التابعة لـ node.

console.dirxml(document);

نتيجة مثال console.dirxml() أعلاه.

console.error(object [, object, ...])

مستوى السجلّ: Error

تعمل هذه السياسة على طباعة object في وحدة التحكّم، وتنسيقها كخطأ، وتضمين تتبُّع تسلسل استدعاء الدوال البرمجية.

console.error("I'm sorry, Dave. I'm afraid I can't do that.");

نتيجة مثال console.error() أعلاه.

console.group(label)

تجميع الرسائل معًا بشكل مرئي حتى يتم استدعاء "console.groupEnd(label)". استخدِم console.groupCollapsed(label) لتصغير المجموعة عند تسجيلها في "وحدة التحكّم" في البداية.

const label = 'Adolescent Irradiated Espionage Tortoises';
console.group(label);
console.info('Leo');
console.info('Mike');
console.info('Don');
console.info('Raph');
console.groupEnd(label);

نتيجة مثال console.group() أعلاه.

بالإضافة إلى ذلك، يمكنك تضمين المجموعات.

const timeline1 = 'New York 2012';
const timeline2 = 'Camp Lehigh 1970';
console.group(timeline1);
console.info('Mind');
console.info('Time');
console.group(timeline2);
console.info('Space');
console.info('Extra Pym Particles');
console.groupEnd(timeline2);
console.groupEnd(timeline1);

المجموعات المتداخلة.

console.groupCollapsed(label)

كما هي الحال في console.group(label)، يتم تصغير المجموعة في البداية عند تسجيلها في وحدة التحكّم.

console.groupEnd(label)

لإيقاف تجميع الرسائل مرئيًا. يمكنك الاطّلاع على console.group.

console.info(object [, object, ...])

مستوى السجلّ: Info

مماثلة لـ console.log(object [, object, ...]).

console.info('info');

نتيجة مثال console.info() أعلاه.

console.log(object [, object, ...])

مستوى السجلّ: Info

يطبع رسالة إلى وحدة التحكم.

console.log('log');

نتيجة مثال console.log() أعلاه.

console.table(array [, column])

مستوى السجلّ: Info

لتسجيل صفيف من الكائنات كجدول.

var people = [
  {
    first: 'René',
    last: 'Magritte',
  },
  {
    first: 'Chaim',
    last: 'Soutine',
    birthday: '18930113',
  },
  {
    first: 'Henri',
    last: 'Matisse',
  }
];
console.table(people);

نتيجة مثال console.table() أعلاه.

يسجِّل console.table() جميع بيانات الجدول تلقائيًا. لعرض عمود واحد أو مجموعة فرعية من الأعمدة، يمكنك استخدام المعلمة الاختيارية الثانية وتحديد اسم العمود أو أسماءه كسلسلة أو مصفوفة من السلاسل. مثلاً:

console.table(people, ['last', 'birthday']);

مجموعة فرعية من الأعمدة في جدول يتم تسجيلها باستخدام console.table().

console.time([label])

يؤدي النقر على هذا الزر إلى بدء موقّت جديد. اطلب console.timeEnd([label]) لإيقاف الموقّت وطباعة الوقت المنقضي إلى وحدة التحكّم.

console.time();
for (var i = 0; i < 100000; i++) {
  let square = i ** 2;
}
console.timeEnd();

نتيجة مثال console.time() أعلاه.

console.timeEnd([label])

مستوى السجلّ: Info

يوقف الموقت. يمكنك الاطّلاع على console.time().

console.trace()

مستوى السجلّ: Info

طباعة تتبُّع تسلسل استدعاء الدوال البرمجية على وحدة التحكّم.

const first = () => { second(); };
const second = () => { third(); };
const third = () => { fourth(); };
const fourth = () => { console.trace(); };
first();

نتيجة مثال console.trace() أعلاه.

console.warn(object [, object, ...])

مستوى السجلّ: Warning

يطبع تحذيرًا في وحدة التحكم.

console.warn('warn');

نتيجة مثال console.warn() أعلاه.