Bendi新闻
>
服务端来自火星,客户端来自金星,RSC 开发新思路

服务端来自火星,客户端来自金星,RSC 开发新思路

9月前


作者 | Michael Shilman
译者 | 许学文
策划 | 丁晓昀

将 Storybook 升级到 8.0alpha 版本,可支持 React 服务端组件。

在基于 React 的 Web UI 开发中,React 服务端组件(RSC) 是一种新的编程模式。与传统的 React “客户端”组件不同,它们只在服务器上进行渲染。这为性能和安全方面带来了一些好处,但与当下的各种 React 工具和库相比,其用法有很大的差异。

其中受影响最大的领域之一就是基于组件驱动的开发和测试。诸如 Storybook、Testing Library 以及用于组件测试的工具 Playwright 和 Cypress,全都是假设用户组件在浏览器(或 JSDom)中进行渲染。但是对于服务器组件来说,情况就不再是这样了。

因此,这就引出了一个问题:该如何独立进行服务器端组件的开发和测试呢?

今天,我很高兴地宣布,Storybook 的 Next.js 框架将提供 RSC 支持,算是作为上述问题的一个尝试性的解决方案。由于它是一个纯客户端实现,所以能很好的集成和适配整个 Storybook 插件生态。

本文介绍了它的工作原理和用法,并提供了一个简单的教程。

服务端来自火星,
客户端来自金星

RSC 与传统的客户端组件有两个主要区别,如下代码所示:

// ApiCard.tsximport { ComponentProps } from 'react';import { Card } from './Card';import { findById } from './db';export async function DbCard({ id }: {id: number}) {  let props;  try {    const contact = await findById(id);    props = { state: 'success', contact };  } catch (e) {    props = { state: 'error' };  }  return <Card {...props} />;}
  1. 第一个区别是:服务端组件是异步的,而这在客户端上是不支持的。

  2. 第二个区别是:服务端组件可以直接访问 Node 代码,在这个示例中,函数 findById 封装了一个经过验证的数据库连接。

为了实现这两点,RSC 在底层做了很多事情。这段代码只能在服务器上运行,并生成一个静态的、类似 JSON 的结构,然后通过流的方式传输给客户端。

Storybook 是一个纯客户端应用。它是一个用于生成纯 HTML/CSS/JS 的静态构建,没有任何 Node 的影子!因此,如果要支持 RSC,就需要解决两个问题:要么找出如何在客户端上渲染 RSC 的方法,要么为服务端渲染重构 Storybook。

我们首先专注于客户端方法。这是因为,我们希望最大程度地减少对用户的影响,毕竟这些用户已经在当前的架构下编写了数百万个用例和上百个插件。

那么,它到底是如何实现的呢?

开始支持异步

如何支持异步组件是在客户端上渲染 RSC 组件的第一个挑战。幸运的是,在 Next.js 最新依赖的 React 版本中已经(非官方地)支持了这一功能。我们要特别感谢 JamesManningR 和 julRuss,他们为此提供了一个简单的解决方案!

import { Suspense } from 'react';export const ClientContact = ({ id }) => (  <Suspense><DbCard id={id} /></Suspense>);

从 Storybook 8 开始,通过在.storybook/main.js 中开启 experimentalNextRSC 特性,@storybook/nextjs 就会自动将你的 story 封装在 Suspense 中:

// .storybook/main.jsexport default {  features: {    experimentalNextRSC: true,  }};

在 @storybook/nextjs 7.x 版本中,你也可以手动将 RSC story 封装到装饰器中。

注意: 这个解决方案目前还不能在其他 Storybook React 框架(例如 react-vite、react-webpack5)中使用,因为它们没有像 Next.js 那样使用 canary 版的 React。希望下一个 React 版本能消除这个限制。

模拟和加载

解决异步问题只解决了一半的问题。为了完成组件数据的填充,我们的 DbCard 组件是通过调用 Node 代码获取数据。然而,Node 代码在浏览器中无法执行,这就导致了问题!

为了解决这个问题,我们建议搭建一个干净的数据访问层。这也是 RSC 架构师推荐的最佳实践。

创建好数据访问层后,你就可以在浏览器中通过模拟来运行它,并精确控制返回的数据,展示不同的用户界面状态(加载中、错误、成功等)。

你可以使用模块模拟网络模拟来模拟数据访问层,这两种方式 Storybook 都支持。

模块模拟:有一个叫做 storybook-addon-module-mock 的社区插件,它提供了和 jest.mock(仅适用于 Webpack 项目)类似的模拟功能。当然,也可以使用 webpack/vite 的别名实现一个简单但功能有限的解决方案。我们计划在 Storybook 的未来版本中提供更便捷的模块模拟功能。

网络 API 模拟:为了模拟网络请求,我们推荐使用 Mock Service Worker (msw)。当然 Storybook 还支持许多其他网络和 GraphQL 模拟插件。

回到上面的例子,下面是一个使用了 storybook-addon-module-mock 的 story:

// DbCard.stories.jsimport { StoryObj, Meta } from '@storybook/react';import { createMock } from 'storybook-addon-module-mock';import { DbCard } from './DbCard';import * as db from './db';export default { component: DbCard };export const Success {  args: { id: 1 },  parameters: {    moduleMock: {      mock: () => {        const mock = createMock(db, 'findById');        mock.mockReturnValue(Promise.resolve({          name: 'Beyonce',          img: 'https://blackhistorywall.files.wordpress.com/2010/02/picture-device-independent-bitmap-119.jpg',          tel: '+123 456 789',          email: '[email protected]'        }))        return [mock];      },    },  },}
完整 Demo:API+ 模块模拟

要了解完整示例,包括使用模块模拟数据库版本和使用 MSW2 模拟 API 版本,请查看完整的StorybookRSC 示例 或 GitHub 仓库。

有什么问题吗?

在本文中,我们成功地在 Storybook 中为 RSC 编写了第一个 story,并展示了这一切是在幕后是如何实现的。

虽然所有事情都相当的简单明了,但是这种方法还是会有一些限制:

  1. 保真度:纯客户端实现与在应用程序中实际运行的服务端流式 RSC 相比依然存在显著的差异。

  2. 便利性: 这里的模拟解决方案肯定还有改进的空间。当前的模块模拟解决方案不仅冗长,且与 Storybook 的 参数 / 控件 也兼容的不够好。

我们计划在后续的迭代中解决这两个问题,这也是为什么我们将此解决方案标记为实验性的原因。

现在就在 Storybook 中
进行 RSC 开发吧

要使用 Storybook 进行 RSC 开发,请将 Storybook 升级到 8.0-alpha 版本:

npx storybook@next upgrade --prerelease

然后,在项目的.storybook/main.ts 文件中将实验性功能开启:

// .storybook/main.jsexport default {  features: {    experimentalNextRSC: true,    },  };}

更多信息,请参阅 @storybook/nextjs 的 README 文档。

本文是详细介绍 Storybook 8.0 的第一篇文章,在接下来的几个月里我们将发布更多的内容。请关注我们的社交媒体或订阅 Storybook 新闻资讯,获取 Storybook 下个版本的全部信息!

原文地址

https://storybook.js.org/blog/storybook-react-server-components/

相关阅读

从 Styleguidist 迁移到 Storybook(https://www.infoq.cn/article/SSjTSB0H2NPb02wwOJxz?utm_campaign=geek_search&utm_content)

HTML5 Web Sockets 与代理服务器交互 (https://www.infoq.cn/article/Web-Sockets-Proxy-Servers?utm_campaign)

从新 React 文档看未来 Web 的开发趋势 (https://www.infoq.cn/article/Tv3SyqoivXMWUoj8qSMT)

如何快速构建 React 组件库 (https://www.infoq.cn/article/6s2QNpu3EvR0LS5mHa3b?utm_campaign)

声明:本文为 InfoQ 翻译,未经许可禁止转载。

点击底部阅读原文访问 InfoQ 官网,获取更多精彩内容!

今日好文推荐

并发王座易主?Java 21 虚拟线程强势崛起,Go & Kotlin还稳得住吗 | 盘点

谷歌新年大裁员,引硅谷裁员潮!OpenAI正式推出GPT Store,但第一批应用已被像素级抄袭;腾讯服务器深夜崩溃 | Q资讯

纯向量数据库和向量插件都有局限,那未来发展有其他方向吗?

系统 bug 致百人入狱,砸了 2.8 亿元仍上云失败!二十年了,这家大企业被日本软件坑惨了

微信扫码关注该文公众号作者

来源:InfoQ

相关新闻

如何在 Linux 上轻松设置 OpenVPN 服务器和客户端:完整教程与实用技巧轻松配置NFS服务:CentOS7服务器与客户端自动挂载指南前端最新趋势:JS正在向服务器端转移、开发者最爱Vue技术栈、Bun越来越受关注新媒体营销服务商:旭航集团,来自浙江杭州,递交IPO招股书,拟赴美国上市雍禾医疗2023年营收同比增长25.8%:高端服务占比提升、多维创新领跑行业科技快讯 | 亚马逊中国pc端服务将关闭;暴雪中国回应全球裁员Node.js 22:服务器端 JavaScript 的未来时代的眼泪,Kindle中国电子书店今日停止云端下载服务微软跨平台开发新思路:React Native 如何赋能 Office、Teams、Xbox 等应用?颜宁等五位女科学家获表彰!她们为开发疾病新疗法提供思路财经早参丨证监会重申!以投资者为本;亚马逊中国电脑端27日关闭购物服务;特朗普被裁定赔偿8330万美元PaaS云服务商:有信云,来自广东广州,递交IPO招股书,拟赴美国上市人力资本管理服务提供商:罗科仕 ,来自北京,美国纳斯达克上市路演PPT(25页)康迈迪森:打造计算化学和AI驱动新药研发平台,已服务数十家客户无限期停滞!邮递员遭无端枪击,加州富裕社区无限期暂停派件服务下跪端茶倒水、喂食……电竞剧本馆恶意营销“女仆服务”被罚火爆!纽约美业人的培训基地!全美高端院线产品批发!一站式美容美体服务就在这!​张雪峰炮轰“文科都是服务业”遭起诉,我却有了养孩子的新思路……智爱「智慧律师」与国浩律师(济南)事务所林泽若明团队成功签约,共绘法律服务新篇章AI辅助冷冻电镜解析纤毛结构,浙大学者构建候选致病基因库,提供纤毛病研究新思路清华妈妈开辟“鸡娃”新思路:理工科学霸花10年卷艺术!超绝创造力,才是决胜未来的密码...热血创业+现实商战,《赤热》是如何打开“科创剧”新思路的?高配养娃新思路:不到9块钱,过奥巴马女儿同款暑假赫尔佐格·德梅隆爆改的小酒店,解锁改建新思路
logo
联系我们隐私协议©2024 bendi.news
Bendi新闻
Bendi.news刊载任何文章,不代表同意其说法或描述,仅为提供更多信息,也不构成任何建议。文章信息的合法性及真实性由其作者负责,与Bendi.news及其运营公司无关。欢迎投稿,如发现稿件侵权,或作者不愿在本网发表文章,请版权拥有者通知本网处理。