A set of macros for interfacing with console.log, console.error and other browser console APIs when targeting Wasm.
Go to file
Rob Watson 945e7ed8e6 Bump version to 0.4.0-beta.1 2020-11-13 10:20:15 +01:00
examples/web-sys Bump version to 0.4.0-beta.1 2020-11-13 10:20:15 +01:00
src WIP: support re-exporting macros 2020-11-12 17:48:09 +01:00
weblog-proc-macro Bump version to 0.4.0-beta.1 2020-11-13 10:20:15 +01:00
.gitignore Refactor to proc-macro 2020-10-19 17:11:53 +02:00
Cargo.toml Bump version to 0.4.0-beta.1 2020-11-13 10:20:15 +01:00
Makefile Refactor to proc-macro 2020-10-19 17:11:53 +02:00
README.md Add badges 2020-10-19 17:59:26 +02:00

README.md

Weblog

Crates.io version docs.rs docs

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
);

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

# Defaults to web-sys
weblog = "0.3.0"

# For stdweb:
weblog = { version = "0.3.0", default-features = false, features = ["std_web"] }

See the documentation for usage examples.

The crate currently exposes the following macros:

  • console_assert!
  • console_clear!
  • console_count!
  • console_count_reset!
  • console_debug!
  • console_dir!
  • console_dirxml!
  • console_error!
  • console_exception!
  • console_info!
  • console_log!
  • console_table!
  • console_time!
  • console_time_end!
  • console_time_stamp!
  • console_trace!
  • console_warn!

License

Licensed under MIT or Apache-2.