משתמשים ב- Console API כדי לכתוב הודעות למסוף מ-JavaScript. אפשר לעיין בקטע תחילת העבודה עם רישום הודעות במסוף להקדמה אינטראקטיבית בנושא.
אם אתם מחפשים את שיטות הנוחות כמו debug(function)
או
monitorEvents(node)
שזמינים רק במסוף.
console.assert(expression, אובייקט)
רמת היומן: 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.clear()
ניקוי המסוף.
console.clear();
אם ההגדרה שימור יומן מופעלת, console.clear()
מושבת.
לחלופין, אפשר לנקות את המסוף בלחיצה על הסמל .
console.count([label])
רמת היומן: Info
כתיבת מספר הפעמים שבהן count()
הופעל באותה שורה ובאותה
label
. כדי לאפס את הספירה, צריך להתקשר אל console.countReset([label])
.
console.count();
console.count('coffee');
console.count();
console.count();
console.countReset([label])
איפוס הספירה.
console.countReset();
console.countReset('coffee');
console.createTask(name)
הפונקציה מחזירה מופע Task
שמשייך את דוח הקריסות הנוכחי לאובייקט task
שנוצר. בהמשך תוכלו להשתמש באובייקט task
הזה כדי להריץ פונקציה (f
בדוגמה הבאה). ה-task.run(f)
מפעיל מטען ייעודי (payload) שרירותי ומעביר את הערך המוחזר חזרה למבצע הקריאה החוזרת.
// 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.dir(object)
רמת היומן: Info
מדפיסה ייצוג JSON של האובייקט שצוין.
console.dir(document.head);
console.dirxml(node)
רמת היומן: Info
מדפיסה ייצוג XML של הצאצאים של node
.
console.dirxml(document);
console.error(object [, object, ...])
רמת היומן: Error
מדפיסה את object
למסוף, מעצבת אותו כשגיאה וכוללת דוח קריסות.
console.error("I'm sorry, Dave. I'm afraid I can't do that.");
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);
אפשר גם להציב קבוצות בתוך היררכיה.
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.log(object [, object, ...])
רמת היומן: Info
מדפיסה הודעה למסוף.
console.log('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(people, ['last', 'birthday']);
console.time([label])
הפעלת טיימר חדש. צריך להתקשר אל console.timeEnd([label])
כדי לעצור את הטיימר ולהדפיס את הזמן שחלף ל-
המסוף.
console.time();
for (var i = 0; i < 100000; i++) {
let square = i ** 2;
}
console.timeEnd();
console.timeEnd([label])
רמת היומן: Info
הפסקת טיימר. פרטים נוספים זמינים בכתובת console.time()
.
console.trace()
רמת היומן: Info
מדפיסה דוח קריסות למסוף.
const first = () => { second(); };
const second = () => { third(); };
const third = () => { fourth(); };
const fourth = () => { console.trace(); };
first();
console.warn(object [, object, ...])
רמת היומן: Warning
מדפיסה אזהרה למסוף.
console.warn('warn');