[−][src]Crate weblog

weblog is a crate that defines a set of macros for calling console.log(), console.error() and other members of the browser's console API when targeting Wasm.

Features

Supports web-sys and stdweb backends with an identical public API
Support for variadic arguments on all calls
No stringification before sending to the browser - log entire objects and use the full introspective debugging power of the browser console.

Examples

A simple example.

console_log!("Hello world!");

Passing multiple arguments is fine too.

console_log!("Foo", "bar", "baz");

All of the common browser log levels are supported.

console_debug!("Just testing...");
console_warn!("...but then...");
console_error!("...something bad happened.");

It's possible to send more than just strings or &strs:

console_log!(
    "&str",
    "string".to_string(),
    1,
    2.0,
    3f32,
    true,
    false,
    Some("option"),
);

When using web-sys crate the macros accept any value that implements the Into<JsValue> trait. See JsValue for more details.

No stringification is performed on the Rust side - so objects will be fully introspectable in the browser's console!

Usage

By default, the crate assumes the presence of the web-sys crate.

weblog = "0.1"

If you'd prefer to use it with stdweb, enable the feature in Cargo.toml:

weblog = { version = "0.1", default-features = false, features = ["stdweb"] }

Macros

console_clear	Call the browser's `console.clear()` function.
console_debug	Call the browser's `console.debug()` function.
console_dir	Call the browser's `console.dir()` function.
console_dirxml	Call the browser's `console.dirxml()` function.
console_error	Call the browser's `console.error()` function.
console_info	Call the browser's `console.info()` function.
console_log	Call the browser's `console.log()` function.
console_trace	Call the browser's `console.trace()` function.
console_warn	Call the browser's `console.warn()` function.