4 releases

0.1.3 Nov 30, 2023
0.1.2 Aug 19, 2022
0.1.1 Aug 19, 2022
0.1.0 Aug 19, 2022

#76 in Debugging

Download history 3957/week @ 2023-12-13 5473/week @ 2023-12-20 4003/week @ 2023-12-27 7145/week @ 2024-01-03 8011/week @ 2024-01-10 9504/week @ 2024-01-17 11647/week @ 2024-01-24 7483/week @ 2024-01-31 9469/week @ 2024-02-07 7073/week @ 2024-02-14 6638/week @ 2024-02-21 5997/week @ 2024-02-28 5587/week @ 2024-03-06 6308/week @ 2024-03-13 5481/week @ 2024-03-20 4513/week @ 2024-03-27

23,295 downloads per month
Used in 8 crates (6 directly)

MIT/Apache

27KB
427 lines

tracing-web

A tracing compatible subscriber layer for web platforms.

Crates.io Documentation MIT licensed Apache licensed

Documentation

Overview

tracing-web can be used in conjunction with the tracing-subscriber crate to quickly install a subscriber that emits messages to the dev-tools console, and events to the Performance API. An example configuration can look like

use tracing_web::{MakeWebConsoleWriter, performance_layer};
use tracing_subscriber::fmt::format::Pretty;
use tracing_subscriber::prelude::*;

fn main() {
    let fmt_layer = tracing_subscriber::fmt::layer()
        .with_ansi(false) // Only partially supported across browsers
        .without_time()   // std::time is not available in browsers, see note below
        .with_writer(MakeWebConsoleWriter::new()); // write events to the console
    let perf_layer = performance_layer()
        .with_details_from_fields(Pretty::default());

    tracing_subscriber::registry()
        .with(fmt_layer)
        .with(perf_layer)
        .init(); // Install these as subscribers to tracing events

    todo!("write your awesome application");
}

Note: You can alternatively use .with_timer(UtcTime::rfc_3339()) with UtcTime on web targets if you enable the wasm-bindgen feature of the time crate, for example by adding the following to your Cargo.toml.

time = { version = "0.3", features = ["wasm-bindgen"] }

License

This project is dual licensed under the MIT license and the Apache license.

Dependencies

~9.5MB
~185K SLoC