مرجع Console API

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

از Console API برای نوشتن پیام در Console از JavaScript استفاده کنید. برای آشنایی تعاملی با این موضوع، شروع کار با ثبت پیام‌ها در «کنسول» را ببینید.

اگر به‌دنبال روش‌های راحتی مثل 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 پیوندی بین بافت ایجاد و بافت تابع ناهمگام ایجاد می‌کند. این پیوند به DevTools اجازه می‌دهد ردیابی‌های پشته بهتری برای عملیات غیرهمگام نشان دهد. برای اطلاعات بیشتر، به رد پشته پیوندشده مراجعه کنید.

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()‎ در بالا.