dart_print-multiple-objects_skill

Overview

This skill shows how to print multiple objects to the console in Dart by leveraging Records, giving a compact alternative to JavaScript's console.log. It demonstrates simple patterns for printing positional and named record fields and practical examples including timestamps and stack traces. The guidance is concise and ready to use in scripts, debugging sessions, and quick experiments.

How this skill works

Dart's print() accepts a single Object? argument. By wrapping multiple values inside a Record literal (e.g., (a, b) or (a, name: b)), you create a single object that holds multiple items. Passing that Record to print() displays all values in a single, readable tuple-like representation. Records preserve positional and named elements which appear in the printed output.

When to use it

• Quick debugging where you want to inspect multiple values in one line.
• Replace multiple sequential print calls for clearer, grouped output.
• Log timestamps alongside values for lightweight tracing without a logging library.
• Show combined error context such as a value with a StackTrace.
• Small scripts, REPL sessions, or examples where structured but minimal output is desired.

Best practices

• Use Records for small groups of related values; switch to a logging package for structured logs in production.
• Prefer named record fields for clarity when printing more than two items (e.g., (time, count: n)).
• Avoid printing large or sensitive objects directly; serialize or redact as needed before printing.
• Keep print calls for development and debugging; remove or gate them behind debug flags in release builds.
• Format complex values (like DateTime) before inserting into a Record if you need a specific string format.

Example use cases

• Print a value and its label: print((count, 'items')); // (3, items)
• Log a timestamp with a message: print((DateTime.now(), message));
• Include named fields: print((DateTime.now(), count: items.length, description: message));
• Print an error with current stack trace for quick debugging: print((DateTime.now(), StackTrace.current));
• Replace multiple prints: print((a, b, c)) instead of three separate print() calls.