הפניית API של Console

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

אפשר להשתמש ב-Console API כדי לכתוב הודעות ל-Console מ-JavaScript. במאמר תחילת העבודה עם רישום הודעות ביומן במסוף יש מבוא אינטראקטיבי לנושא.

אם אתם מחפשים שיטות נוחות כמו debug(function) או monitorEvents(node) שזמינות רק מ-Console, עיינו במאמרי העזרה של ה-API של Console utilities.

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) מפעילה מטען ייעודי (payload) שרירותי ומעבירה את הערך שמוחזר בחזרה לפונקציית הקריאה החוזרת (caller).

// 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) כדי לכווץ את הקבוצה כשהיא נרשמת לראשונה ב-Console.

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.

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()‎ שלמעלה.