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

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

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

اطّلِع على مرجع واجهة برمجة التطبيقات Console utilities إذا كنت تبحث عن الطرق المريحة، مثل 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();

إذا كان الخيار الاحتفاظ بالسجلّ مفعّلاً، يتم إيقاف 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 [, columns])

مستوى السجلّ: 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().

لنسخ جدول مسجَّل إلى الحافظة كجدول بتنسيق Markdown أو بيانات CSV، انقر بزر الماوس الأيمن على الجدول في وحدة التحكّم واختَر خيار النسخ المقابل من قائمة السياق.

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()‎ أعلاه