Suspense boundaries/out of order streaming/anyhow like error handling (#2365)
* create static site generation helpers in the router crate * work on integrating static site generation into fullstack * move ssg into a separate crate * integrate ssg with the launch builder * simplify ssg example * fix static_routes for child routes * move CLI hot reloading websocket code into dioxus-hot-reload * fix some unused imports * use the same hot reloading websocket code for fullstack * fix fullstack hot reloading * move cli hot reloading logic into the hot reload crate * ssg example working with dx serve * add more examples * fix clippy * switch to a result for Element * fix formatting * fix hot reload doctest imports * fix axum imports * add show method to error context * implement retaining nodes during suspense * fix unterminated if statements * communicate between tasks and suspense boundaries * make suspense placeholders easier to use * implement IntoDynNode and IntoVNode for more wrappers * fix clippy examples * fix rsx tests * add streaming html utilities to the ssr package * unify hydration and non-hydration ssr cache * fix router with Result Element * don't run server doc tests * Fix hot reload websocket doc examples * simple apps working with fullstack streaming * fix preloading wasm * Report errors encountered while streaming * remove async from incremental renderer * document new VirtualDom suspense methods * make streaming work with incremental rendering * fix static site generation * document suspense structs * create closure type; allow async event handlers in props; allow shorthand event handlers * test forwarding event handlers with the shorthand syntax * fix clippy * fix imports in spawn async doctest * fix empty rsx * fix async result event handlers * fix mounting router in multiple places * Fix task dead cancel race condition * simplify diffing before adding suspense * fix binary size increase * fix attribute diffing * more diffing fixes * create minimal fullstack feature * smaller fullstack bundles * allow mounting nodes that are already created and creating nodes without mounting them * fix hot reload feature * fix replacing components * don't reclaim virtual nodes * client side suspense working! * fix CLI * slightly smaller fullstack builds * fix multiple suspended scopes * fix merge errors * yield back to tokio every few polls to fix suspending on many tasks at once * remove logs * document suspense boundary and update suspense example * fix ssg * make streaming optional * fix some router and core tests * fix suspense example * fix serialization with out of order server futures * add incremental streaming hackernews demo * fix hackernews demo * fix root hackernews redirect * fix formatting * add tests for suspense cases * slightly smaller binaries * slightly smaller * improve error handling docs * fix errors example link * fix doc tests * remove log file * fix ssr cache type inference * remove index.html * fix ssg render template * fix assigning ids on elements with dynamic attributes * add desktop feature to the workspace examples * remove router static generation example; ssg lives in the dioxus-static-generation package * add a test for effects during suspense * only run effects on mounted nodes * fix multiple suspense roots * fix node iterator * fix closures without arguments * fix dioxus-core readme doctest * remove suspense logs * fix scope stack * fix clippy * remove unused suspense boundary from hackernews * assert that launch never returns for better compiler errors * fix static generation launch function * fix web renderer * pass context providers into server functions * add an example for FromContext * clean up DioxusRouterExt * fix server function context * fix fullstack desktop example * forward CLI serve settings to fullstack * re-export serve config at the root of fullstack * forward env directly instead of using a guard * just set the port in the CLI for fullstack playwright tests * fix fullstack dioxus-cli-config feature * fix launch server merge conflicts * fix fullstack launch context * Merge branch 'main' into suspense-2.0 * fix fullstack html data * remove drop virtual dom feature * add a comment about only_write_templates binary size workaround * remove explicit dependencies from use_server_future * make ErrorContext and SuspenseContext more similar * Tweak: small tweaks to tomls to make diff smaller * only rerun components under suspense after the initial placeholders are sent to the client * add module docs for suspense * keep track of when suspense boundaries are resolved * start implementing JS out of order streaming * fix core tests * implement the server side of suspense with js * fix streaming ssr with nested suspense * move streaming ssr code into fullstack * revert minification changes * serialize server future data as the html streams * start loading scripts wasm immediately instead of defering the script * very basic nested suspense example working with minimal html updates * clean up some suspense/error docs * fix hydrating nested pending server futures * sort resolved boundaries by height * Fix disconnecting clients while streaming * fix static generation crate * don't insert extra divs when hydrating streamed chunks * wait to swap in the elements until they are hydrated * remove inline streaming script * hackernews partially working * fix spa mode * banish the open shadow dom * fix removing placeholder * set up streaming playwright test * run web playwright tests on 9999 to avoid port conflicts with other local servers * remove suspense nodes if the suspense boundary is replaced before the suspense resolves on the server * ignore hydration of removed suspense boundaries * use path based indexing to fix hydrating suspense after parent suspense with child is removed * re-export dioxus error * remove resolved suspense divs if the suspense boundary has been removed * Fix client side initialized server futures * ignore comment nodes while traversing nodes in core to avoid lists getting swapped out with suspense * Pass initial hydration data to the client * hide pre nodes * don't panic if reclaiming an element fails * fix scope stack when polling tasks * improve deserialization out of length message * Ok(VNode::placeholder()) -> VNode::empty() * fix typo in rsx usage * restore testing changes from suspense example * clean up some logs and comments * fix playwright tests * clean up more changes in core * clean up core tests * remove anymap dependency * clean up changes to hooks * clean up changes in the router, rsx, and web * revert changes to axum-hello-world * fix use_server_future * fix clippy in dioxus-core * check that the next or previous node exist before checking if we should ignore them * fix formatting * fix suspense playwright test * remove unused suspense code * add more suspense playwright tests * add more docs for error boundaries * fix suspense core tests * fix ErrorBoundary example * remove a bunch of debug logging in js * fix router failure_external_navigation * use absolute paths in the interpreter build.rs * strip '\r' while hashing ts files * add a wrapper with a default error boundary and suspense boundary * restore hot reloading * ignore non-ts files when hashing * sort ts files before hashing them * fix rsx tests * fix fullstack doc tests * fix core tests * fix axum auth example * update suspense hydration diagram * longer playwright build limit * tiny fixes - spelling, formatting * update diagram link * remove comment and template nodes for suspense placeholders * remove comment nodes as we hydrate text * simplify hackernews example * clean up hydrating text nodes * switch to a separate environment variable for the base path for smaller binaries * clean up file system html trait * fix form data * move streaming code into fullstack * implement serialize and deserialize for CapturedError * remove waits in the nested suspense playwright spec * force sequential fullstack builds for CI * longer nested suspense delay for CI * fix --force-sequential flag * wait to launch server until client build is done --------- Co-authored-by: Jonathan Kelley <jkelleyrtp@gmail.com>
This commit is contained in:
Evan AlmloffandJonathan Kelley authored and GitHub committed
1 parent
ffa36a67c3
commit
022e4ad203
175 files changed
+7872
-4010
No files matched your search
@@ -1,3 +1,4 @@
|
||||
use dioxus_lib::prelude::use_hook;
|
||||
use serde::{de::DeserializeOwned, Serialize};
|
||||
|
||||
/// This allows you to send data from the server to the client. The data is serialized into the HTML on the server and hydrated on the client.
|
||||
@@ -12,25 +13,36 @@ use serde::{de::DeserializeOwned, Serialize};
|
||||
/// use dioxus_fullstack::prelude::*;
|
||||
///
|
||||
/// fn app() -> Element {
|
||||
/// let state1 = server_cached(|| {
|
||||
/// let state1 = use_server_cached(|| {
|
||||
/// 1234
|
||||
/// });
|
||||
///
|
||||
/// None
|
||||
/// todo!()
|
||||
/// }
|
||||
/// ```
|
||||
pub fn server_cached<O: 'static + Serialize + DeserializeOwned>(server_fn: impl Fn() -> O) -> O {
|
||||
pub fn use_server_cached<O: 'static + Clone + Serialize + DeserializeOwned>(
|
||||
server_fn: impl Fn() -> O,
|
||||
) -> O {
|
||||
#[cfg(feature = "server")]
|
||||
{
|
||||
let data = server_fn();
|
||||
let sc = crate::prelude::server_context();
|
||||
if let Err(err) = sc.push_html_data(&data) {
|
||||
tracing::error!("Failed to push HTML data: {}", err);
|
||||
}
|
||||
data
|
||||
let serialize = crate::html_storage::use_serialize_context();
|
||||
use_hook(|| {
|
||||
let data = server_fn();
|
||||
serialize.push(&data);
|
||||
data
|
||||
})
|
||||
}
|
||||
#[cfg(not(feature = "server"))]
|
||||
#[cfg(all(not(feature = "server"), feature = "web"))]
|
||||
{
|
||||
crate::html_storage::deserialize::take_server_data().unwrap_or_else(server_fn)
|
||||
use_hook(|| {
|
||||
dioxus_web::take_server_data()
|
||||
.ok()
|
||||
.flatten()
|
||||
.unwrap_or_else(server_fn)
|
||||
})
|
||||
}
|
||||
#[cfg(not(any(feature = "server", feature = "web")))]
|
||||
{
|
||||
use_hook(server_fn)
|
||||
}
|
||||
}
|
||||
@@ -2,46 +2,121 @@ use dioxus_lib::prelude::*;
|
||||
use serde::{de::DeserializeOwned, Serialize};
|
||||
use std::future::Future;
|
||||
|
||||
/// A future that resolves to a value.
|
||||
/// Runs a future with a manual list of dependencies and returns a resource with the result if the future is finished or a suspended error if it is still running.
|
||||
///
|
||||
///
|
||||
/// On the server, this will wait until the future is resolved before continuing to render. When the future is resolved, the result will be serialized into the page and hydrated on the client without rerunning the future.
|
||||
///
|
||||
///
|
||||
/// <div class="warning">
|
||||
///
|
||||
/// Unlike [`use_resource`] dependencies are only tracked inside the function that spawns the async block, not the async block itself.
|
||||
///
|
||||
/// ```rust, no_run
|
||||
/// # use dioxus::prelude::*;
|
||||
/// // ❌ The future inside of use_server_future is not reactive
|
||||
/// let id = use_signal(|| 0);
|
||||
/// use_server_future(move || {
|
||||
/// async move {
|
||||
/// // But the future is not reactive which means that the future will not subscribe to any reads here
|
||||
/// println!("{id}");
|
||||
/// }
|
||||
/// });
|
||||
/// // ✅ The closure that creates the future for use_server_future is reactive
|
||||
/// let id = use_signal(|| 0);
|
||||
/// use_server_future(move || {
|
||||
/// // The closure itself is reactive which means the future will subscribe to any signals you read here
|
||||
/// let cloned_id = id();
|
||||
/// async move {
|
||||
/// // But the future is not reactive which means that the future will not subscribe to any reads here
|
||||
/// println!("{cloned_id}");
|
||||
/// }
|
||||
/// });
|
||||
/// ```
|
||||
///
|
||||
/// </div>
|
||||
///
|
||||
/// # Example
|
||||
///
|
||||
/// ```rust, no_run
|
||||
/// # use dioxus::prelude::*;
|
||||
/// # async fn fetch_article(id: u32) -> String { todo!() }
|
||||
/// use dioxus::prelude::*;
|
||||
///
|
||||
/// fn App() -> Element {
|
||||
/// let mut article_id = use_signal(|| 0);
|
||||
/// // `use_server_future` will spawn a task that runs on the server and serializes the result to send to the client.
|
||||
/// // The future will rerun any time the
|
||||
/// // Since we bubble up the suspense with `?`, the server will wait for the future to resolve before rendering
|
||||
/// let article = use_server_future(move || fetch_article(article_id()))?;
|
||||
///
|
||||
/// rsx! {
|
||||
/// "{article().unwrap()}"
|
||||
/// }
|
||||
/// }
|
||||
/// ```
|
||||
#[must_use = "Consider using `cx.spawn` to run a future without reading its value"]
|
||||
pub fn use_server_future<T, F>(_future: impl FnMut() -> F + 'static) -> Option<Resource<T>>
|
||||
pub fn use_server_future<T, F>(
|
||||
mut future: impl FnMut() -> F + 'static,
|
||||
) -> Result<Resource<T>, RenderError>
|
||||
where
|
||||
T: Serialize + DeserializeOwned + 'static,
|
||||
F: Future<Output = T> + 'static,
|
||||
{
|
||||
let cb = use_callback(_future);
|
||||
let mut first_run = use_hook(|| CopyValue::new(true));
|
||||
#[cfg(feature = "server")]
|
||||
let serialize_context = crate::html_storage::use_serialize_context();
|
||||
// We always create a storage entry, even if the data isn't ready yet to make it possible to deserialize pending server futures on the client
|
||||
#[cfg(feature = "server")]
|
||||
let server_storage_entry = use_hook(|| serialize_context.create_entry());
|
||||
|
||||
// If this is the first run and we are on the web client, the data might be cached
|
||||
#[cfg(feature = "web")]
|
||||
let initial_web_result = use_hook(|| {
|
||||
tracing::info!("First run of use_server_future");
|
||||
|
||||
std::rc::Rc::new(std::cell::RefCell::new(Some(
|
||||
dioxus_web::take_server_data::<T>(),
|
||||
)))
|
||||
});
|
||||
|
||||
let resource = use_resource(move || {
|
||||
#[cfg(feature = "server")]
|
||||
let serialize_context = serialize_context.clone();
|
||||
let user_fut = future();
|
||||
#[cfg(feature = "web")]
|
||||
let initial_web_result = initial_web_result.clone();
|
||||
|
||||
async move {
|
||||
let user_fut = cb.call();
|
||||
|
||||
let currently_in_first_run = first_run.cloned();
|
||||
|
||||
// If this is the first run and we are on the web client, the data might be cached
|
||||
if currently_in_first_run {
|
||||
tracing::info!("First run of use_server_future");
|
||||
// This is no longer the first run
|
||||
first_run.set(false);
|
||||
|
||||
#[cfg(feature = "web")]
|
||||
if let Some(o) = crate::html_storage::deserialize::take_server_data::<T>() {
|
||||
// this is going to subscribe this resource to any reactivity given to use in the callback
|
||||
// We're doing this regardless so inputs get tracked, even if we drop the future before polling it
|
||||
kick_future(user_fut);
|
||||
|
||||
return o;
|
||||
#[cfg(feature = "web")]
|
||||
{
|
||||
let initial = initial_web_result.borrow_mut().take();
|
||||
match initial {
|
||||
// This isn't the first run
|
||||
None => {}
|
||||
// This is the first run
|
||||
Some(first_run) => {
|
||||
match first_run {
|
||||
// THe data was deserialized successfully from the server
|
||||
Ok(Some(o)) => return o,
|
||||
// The data is still pending from the server. Don't try to resolve it on the client
|
||||
Ok(None) => {
|
||||
tracing::trace!("Waiting for server data");
|
||||
std::future::pending::<()>().await;
|
||||
}
|
||||
// The data was not available on the server, rerun the future
|
||||
Err(_) => {}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Otherwise just run the future itself
|
||||
let out = user_fut.await;
|
||||
|
||||
// If this is the first run and we are on the server, cache the data
|
||||
// If this is the first run and we are on the server, cache the data in the slot we reserved for it
|
||||
#[cfg(feature = "server")]
|
||||
if currently_in_first_run {
|
||||
let _ = crate::server_context::server_context().push_html_data(&out);
|
||||
}
|
||||
serialize_context.insert(server_storage_entry, &out);
|
||||
|
||||
#[allow(clippy::let_and_return)]
|
||||
out
|
||||
@@ -56,24 +131,12 @@ where
|
||||
// Suspend if the value isn't ready
|
||||
match resource.state().cloned() {
|
||||
UseResourceState::Pending => {
|
||||
suspend(resource.task());
|
||||
None
|
||||
let task = resource.task();
|
||||
if !task.paused() {
|
||||
return Err(suspend(task).unwrap_err());
|
||||
}
|
||||
Ok(resource)
|
||||
}
|
||||
_ => Some(resource),
|
||||
_ => Ok(resource),
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(feature = "web")]
|
||||
#[inline]
|
||||
fn kick_future<F, T>(user_fut: F)
|
||||
where
|
||||
F: Future<Output = T> + 'static,
|
||||
{
|
||||
// Kick the future to subscribe its dependencies
|
||||
use futures_util::future::FutureExt;
|
||||
let waker = futures_util::task::noop_waker();
|
||||
let mut cx = std::task::Context::from_waker(&waker);
|
||||
futures_util::pin_mut!(user_fut);
|
||||
|
||||
let _ = user_fut.poll_unpin(&mut cx);
|
||||
}
|
||||
Reference in new issue
Block a user