19 releases (4 breaking)

new 0.5.0 Nov 8, 2024
0.3.1 Sep 6, 2024
0.1.13 May 5, 2024
0.1.12 Mar 27, 2024
0.1.3 Jul 15, 2023

#81 in Network programming

Download history 884/week @ 2024-07-21 1153/week @ 2024-07-28 1216/week @ 2024-08-04 837/week @ 2024-08-11 751/week @ 2024-08-18 874/week @ 2024-08-25 892/week @ 2024-09-01 457/week @ 2024-09-08 647/week @ 2024-09-15 616/week @ 2024-09-22 1006/week @ 2024-09-29 854/week @ 2024-10-06 574/week @ 2024-10-13 1598/week @ 2024-10-20 955/week @ 2024-10-27 1326/week @ 2024-11-03

4,542 downloads per month
Used in 13 crates (10 directly)

MIT/Apache

430KB
8K SLoC

WTransport Logo

Documentation Crates.io CI Chat

WTransport

WebTransport protocol, pure-rust, async-friendly.

Introduction

WebTransport is a new protocol being developed to enable low-latency, bidirectional communication between clients and servers over the web. It aims to address the limitations of existing protocols like HTTP and WebSocket by offering a more efficient and flexible transport layer.

Benefits of WebTransport

  • 🚀 Low latency: WebTransport is designed to minimize latency, making it suitable for real-time applications such as gaming, video streaming, and collaborative editing.
  • 🔄 Bidirectional communication: WebTransport allows simultaneous data exchange between the client and server, enabling efficient back-and-forth communication without the need for multiple requests.
  • 🔀 Multiplexing: With WebTransport, multiple streams can be multiplexed over a single connection, reducing overhead and improving performance.
  • 🔒 Security: WebTransport benefits from the security features provided by the web platform, including transport encryption and same-origin policy.
  • 🌐 Native Browser Support: WebTransport is natively supported in modern web browsers, ensuring seamless integration and enhanced performance for web applications.

Check Library Documentation

Notes

Please be aware that WebTransport is still a draft and not yet standardized. The WTransport library, while functional, is not considered completely production-ready. It should be used with caution and may undergo changes as the WebTransport specification evolves.

Simple API

Server Client
#[tokio::main]
async fn main() -> Result<()> {
    let config = ServerConfig::builder()
        .with_bind_default(4433)
        .with_identity(&identity)
        .build();

    let connection = Endpoint::server(config)?
        .accept()
        .await     // Awaits connection
        .await?    // Awaits session request
        .accept()  // Accepts request
        .await?;   // Awaits ready session

    let stream = connection.accept_bi().await?;
    // ...
}
#[tokio::main]
async fn main() -> Result<()> {
    let config = ClientConfig::default();

    let connection = Endpoint::client(config)?
        .connect("https://[::1]:4433")
        .await?;

    let stream = connection.open_bi().await?.await?;
    // ...
}

Browser Integration

WebTransport is supported in modern browsers, enhancing the capabilities of web applications.

For instance, you can create a native browser WebTransport client connecting to a Rust server using the following JavaScript code:

// Create a WebTransport instance connecting to the Rust server
let transport = new WebTransport('https://[::1]:4433');
await transport.ready;

// Create a bidirectional stream
let stream = await transport.createBidirectionalStream();

// Send data from the client to the server
await stream.writable.getWriter().write(new TextEncoder().encode("hello"));

// Read data reply from the server
let data = await stream.readable.getReader().read();
console.log(data);

Check out the W3C WebTransport API documentation for more details and to explore the full capabilities of WebTransport in the browser.

Getting Started

Clone the Repository

git clone https://github.com/BiagioFesta/wtransport.git
cd wtransport/

Run Full Example

The examples/full.rs is a minimal but complete server example that demonstrates the usage of WebTransport.

You can run this example using Cargo, Rust's package manager, with the following command:

cargo run --example full

This example initiates an echo WebTransport server that can receive messages. It also includes an integrated HTTP server.

Open a supported web browser and navigate to the page http://127.0.0.1:8080.

Examples

Other Languages

WTransport has bindings for the following languages:

Dependencies

~18–28MB
~525K SLoC