diff --git a/crates/test/README.md b/crates/test/README.md index 442e89c0..7ea4421a 100644 --- a/crates/test/README.md +++ b/crates/test/README.md @@ -33,6 +33,19 @@ ton of documentation just yet, but a taste of how it works is: # or [target.'cfg(target_arch = "wasm32")'.dev-dependencies] wasm-bindgen-test = { git = 'https://github.com/rustwasm/wasm-bindgen' } ``` + + **WARNING**: the `console_error_panic_hook` has a dependency on `wasm-bindgen` + from `crates.io` which conflicts with the one from git used by `wasm-bindgen-test`: + it produces linker errors due to duplicated symbols. + + Until `wasm-bindgen-test` is released on `crates.io`, the temporary workaround + is to patch the `crates.io`'s `wasm-bindgen` dependency to be the same that + `wasm-bindgen-test` uses by adding the following to your project's `Cargo.toml`: + + ```toml + [patch.crates-io] + wasm-bindgen = { git = 'https://github.com/rustwasm/wasm-bindgen' } + ``` * Next, write some tests!