https://github.com/usagi/web-sugars

It's a sugars for web related crates such as `web-sys`, `js-sys`, `wasm-bindgen`s.
https://github.com/usagi/web-sugars

js js-sys rust syntax-sugar wasm wasm-bindgen web web-sys

Last synced: about 2 months ago
JSON representation

It's a sugars for web related crates such as `web-sys`, `js-sys`, `wasm-bindgen`s.

• Host: GitHub
• URL: https://github.com/usagi/web-sugars
• Owner: usagi
• License: mit
• Created: 2020-09-13T16:33:25.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-09-13T16:33:38.000Z (over 4 years ago)
• Last Synced: 2024-10-14T06:09:48.444Z (3 months ago)
• Topics: js, js-sys, rust, syntax-sugar, wasm, wasm-bindgen, web, web-sys
• Language: Rust
• Homepage:
• Size: 11.7 KB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# web-sugars

It's a sugars for web related crates such as `web-sys`, `js-sys`, `wasm-bindgen`s.

## Targets of this crate

- Provide a useful syntax sugars.

- Provide a useful error handlings.

## Non-targets

- An Application specific features.

- An JS library specific features.

## Example

Easy error handling for function of a `#[wasm-bindgen]`, with easy common function calls:

```rust

use web_sugars::prelude::*;

#[wasm_bindgen]

pub fn my_wasm_func() -> Result // <- by wasm-bindgen spec.

{

 // web-sugars functions are returns Result,

 // and WebSugarError has a From trait. Thus, you can type just `?` to throw an error.

 let _window = get_window()?;

 // No need `get_window()?.get_document()?` chains, just call `get_document`.

 let _document = get_document()?;

 // No need `.get_window()?.get_document()?.get_element_by_id()?` chains, just acll `get_element_by_id`.

 let _element = get_element_by_id("target-id")?;

 let _elements = get_elements_by_tag_name("div")?;

 let _xpath_results = evaluate("/html//p")?;

 // Fetch a String data, all of errors are handled by `WebSugarError`.

 let _data: String = fetch_as_string("https://example.com/my_data.txt")?;

 // Fetch a JSON

 let _data: JsValue = fetch_as_string("https://example.com/my_data.json")?;

 // Fetch a JSON, and then deserialize to `MyType` with serde.

 let _data: MyType = fetch_as_json_as::("https://example.com/my_data.json")?;

 // Fetch a binary data to `JsValue` of `ArrayBuffer`

 let _data: JsValue = fetch_as_array-buffer("https://example.com/my_data.bin")?;

 // Get a Vec from JsValue of ArrayBuffer easily

 let _data: Vec = _data.as_vec()?;

 // And more sugars may help you :)

}

```

## License

- [MIT](LICENSE.md)

## Author

- [USAGI.NETWORK / Usagi Ito](https://github.com/usagi)