feat(fetch): Request::fetch

Author: MartinKavik

examples/fetch/src/post.rs

@@ -28,8 +28,7 @@ pub fn update(msg: Msg, model: &mut Model, orders: &mut impl Orders<Msg>) {
 
             let token = "YWxhZGRpbjpvcGVuc2VzYW1l";
             // Created outside async block because of lifetime reasons
-            // (we can't use reference to `model.from` in async
-            // function).
+            // (we can't use reference to `model.form` in async function).
             let request = Request::new("/")
                 .method(Method::Post)
                 .header(Header::custom("Accept-Language", "en"))

examples/server_integration/client/src/example_a.rs

@@ -56,11 +56,14 @@ pub fn update(msg: Msg, model: &mut Model, orders: &mut impl Orders<Msg>) {
 }
 
 async fn send_message(new_message: String) -> fetch::Result<shared::SendMessageResponseBody> {
-    let request = Request::new(get_request_url())
+    Request::new(get_request_url())
         .method(Method::Post)
-        .json(&shared::SendMessageRequestBody { text: new_message })?;
-
-    fetch(request).await?.check_status()?.json().await
+        .json(&shared::SendMessageRequestBody { text: new_message })?
+        .fetch()
+        .await?
+        .check_status()?
+        .json()
+        .await
 }
 
 // ------ ------

examples/server_integration/client/src/example_e.rs

@@ -115,11 +115,13 @@ pub fn update(msg: Msg, model: &mut Model, orders: &mut impl Orders<Msg>) {
 }
 
 async fn send_request(form: FormData) -> fetch::Result<String> {
-    let request = Request::new(get_request_url())
+    Request::new(get_request_url())
         .method(fetch::Method::Post)
-        .body(form.into());
-
-    fetch(request).await?.text().await
+        .body(form.into())
+        .fetch()
+        .await?
+        .text()
+        .await
 }
 
 #[allow(clippy::option_map_unit_fn)]

src/browser/fetch.rs

@@ -3,7 +3,7 @@
 //! Seed Fetch API is very similar to the browser [native one][fetch-mdn].
 //!
 //! There is one entry point: [`fetch`][fetch] function.
-//! It can accept both, string urls as well as [`Request`][request].
+//! It can accept both string urls as well as [`Request`][request].
 //!
 //! To get a [`Response`][response] you need to `.await` fetch:
 //! ```rust

src/browser/fetch/request.rs

@@ -1,6 +1,6 @@
 //! The Request of the Fetch API.
 
-use super::{FetchError, Header, Headers, Method, Result};
+use super::{fetch, FetchError, Header, Headers, Method, Response, Result};
 use crate::browser::Url;
 use gloo_timers::callback::Timeout;
 use serde::Serialize;
@@ -172,6 +172,31 @@ impl<'a> Request<'a> {
         let controller = self.controller.clone();
         (self, controller)
     }
+
+    /// Fetch request. It's a chainable alternative to `fetch(request)`.
+    ///
+    /// # Example
+    ///
+    /// ```rust,no_run
+    /// orders.perform_cmd({
+    ///     let message = model.new_message.clone();
+    ///     async { Msg::Fetched(send_message(message).await) }
+    /// });
+    /// ...
+    /// async fn send_message(new_message: String) -> fetch::Result<shared::SendMessageResponseBody> {
+    ///     Request::new(get_request_url())
+    ///         .method(Method::Post)
+    ///         .json(&shared::SendMessageRequestBody { text: new_message })?
+    ///         .fetch()
+    ///         .await?
+    ///         .check_status()?
+    ///         .json()
+    ///         .await
+    /// }
+    /// ```
+    pub async fn fetch(self) -> Result<Response> {
+        fetch(self).await
+    }
 }
 
 impl<'a, T: Into<Cow<'a, str>>> From<T> for Request<'a> {