9 月 16 日,全栈 Web 框架 Remix 正式发布了 2.0 版本,Remix 团队在发布 1.0 版本后经过近 2 年的持续努力,发布了 19 个次要版本、100 多个补丁版本,并解决了数千个问题和拉取请求,终于迎来了第二个主要版本!
Remix 具有以下特性:
- 追求速度、用户体验(UX),支持任何 SSR/SSG 等
- 基于 Web 基础技术,如 HTML/CSS 与 HTTP 以及 Web Fecth API,在绝大部分情况可以不依赖于 JavaScript 运行,所以可以运行在任何环境下,如 Web Browser、Cloudflare Workers、Serverless 或者 Node.js 等
- 客户端与服务端一致的开发体验,客户端代码与服务端代码写在一个文件里,无缝进行数据交互,同时基于 TypeScript,类型定义可以跨客户端与服务端共用
- 内置文件即路由、动态路由、嵌套路由、资源路由等
- 去掉 Loading、骨架屏等任何加载状态,页面中所有资源都可以预加载(Prefetch),页面几乎可以立即加载
- 告别以往瀑布式(Waterfall)的数据获取方式,数据获取在服务端并行(Parallel)获取,生成完整 HTML 文档,类似 React 的并发特性
- 提供开发网页需要所有状态,开箱即用;提供所有需要使用的组件,包括
、
、
、
、
,用于处理元信息、脚本、CSS、路由和表单相关的内容
- 内置错误处理,针对非预期错误处理的
和开发者抛出错误处理的
Remix 是一个由 React Router 开发团队所开发的基于 React 和 TypeScript 的全栈框架。2021 年 11 月,Remix 正式开源,至今已在 Github 上获得了 24.6k star。Remix 正式开源时,引发了前端圈不小的关注,其被普遍认为是 Next.js 的强劲对手,那时隔两年,它和 Next.js 之间的“竞争”怎么样了呢?
目前,Next.js 拥有 112k star,是 Remix 的近 5 倍。Next.js 周下载量 279 万,而 Remix 仅有 1.4 万,Next.js 是 Remix 的近 200 倍。可见,Remix 并没有像大家预料的那样,成为 Next.js 的有力竞争对手,在开发者社区中只有较小的市场份额。尽管如此,Remix 仍然吸引了一些开发者,并且在特定领域或项目中有其优势和适用性。
下面就来看看 Remix 2.0 都有哪些更新!
v1.0 以来的更新
- v1.8和v1.10中,将 Remix与React Router v6进行了对齐。当开始开发Remix时,承诺它将使React Router变得更好。这个版本真正实现了这一承诺,并将两个库都对齐到使用相同的底层依赖。
- 在v1.11中,发布了"promises over the wire",即延迟加载模块。现在,如果真的想在Remix应用中添加 loading 图标,可以这么做了!
- 在v1.11中,添加了"flat"路由,简化了使用嵌套布局而不需要嵌套目录的操作,这成为v2版本的默认设置。
- 在v1.13和v1.16中,改进了Remix对各种CSS策略的支持,包括PostCSS、CSS模块、Vanilla Extract 和CSS副作用(全局)导入。
- 在v1.14和v1.18中,发布了一个新的开发服务器,支持热更新(HMR)和热数据重载(HDR)。这个新的开发服务器成为v2版本的默认设置。
- 在v2版本中,最重要的亮点之一是全新的
create-remix
命令行工具体验。
v2.0 的更新内容
重大变化
升级的依赖要求
Remix v2已经升级了对React和Node的最低版本支持,并正式支持以下版本:
- React 18
- Node 18 或更高版本
移除未来标志
以下未来标志已被移除,并且它们的行为现在是默认的,现在可以从remix.config.js
文件中删除这些设置。
v2_dev
,新的开发服务器,具有HMR + HDR,如果在future.v2_dev
中有配置而不仅仅是布尔值(例如,future.v2_dev.port
),可以将它们提升到remix.config.js
中的根dev
对象中。v2_errorBoundary
,移除了CatchBoundary
,改为使用单个ErrorBoundary
v2_headers
,修改了嵌套路由场景中的头部逻辑v2_meta
,修改了meta()
的返回格式v2_normalizeFormMethod
,将formMethod
规范化为大写v2_routeConvention
,现在默认情况下,路由使用扁平化路由约定
重大变更/API 删除
下面列出了 Remix v1 中具有弃用警告的其他重大更改/API 删除。如果使用的是最新1.19.3版本且没有任何控制台警告,那么可能可以继续执行所有这些操作!
(1)有破坏性更改/API移除
- remix.config.js
- 将
browserBuildDirectory
重命名为assetsBuildDirectory
- 删除
devServerBroadcastDelay
- 将
devServerPort
重命名为dev.port
- 如果在1.x版本中选择此选项,则配置标记将是
future.v2_dev.port
,但在稳定的2.x版本中,它将是dev.port
- 将默认的
serverModuleFormat
从cjs
更改为esm
- 删除
serverBuildTarget
- 将
serverBuildDirectory
更改为serverBuildPath
- 默认情况下不再在服务器上对Node内置模块进行
polyfill
,必须通过serverNodeBuiltinsPolyfill
选择加入polyfill
- @remix-run/react
删除
useTransition
删除
fetcher.type
并压缩fetcher.submission
现在更准确地被归类为state:“loading”
,而不是state:“submitting”
,以更好地与底层的GET请求保持一致要求
camelCased
版本的imagesrcset/imagesizes
(2)没有弃用警告
此版本没能在每个破坏性更改或API移除上都收到废弃警告。以下是可能需要查看的剩余变更列表,以升级到v2:
- remix.config.js
- Node内置模块不再默认在浏览器中进行polyfill,可以通过
browserNodeBuiltinsPolyfill
选项选择加入polyfill
- 如果存在配置文件,则
PostCSS/Tailwind
将默认启用,可以通过postcss和tailwind标志禁用此功能
- @remix-run/cloudflare
删除
createCloudflareKVSessionStorage
方法不再支持@cloudflare/workers-types v2和v3
@remix-run/dev
删除
REMIX_DEV_HTTP_ORIGIN
,增加REMIX_DEV_ORIGIN
删除
REMIX_DEV_SERVER_WS_PORT
,增加dev.port
或--port
删除
--no-restart/restart
标志,增加--manual/manual
删除
--scheme/scheme
和--host/host
,增加REMIX_DEV_ORIGIN
删除
codemod
命令@remix-run/eslint-config
删除
@remix-run/eslint-config/jest
配置删除魔法
imports
的ESLint警告@remix-run/netlify
@remix-run/netlify
适配器已被删除,推荐使用Netlify官方适配器@remix-run/node
默认不再对
fetch
进行polyfill
,应用需要调用installGlobals()
来安装polyfills
不再从
@remix-run/node
导出fetch
和相关 API,应用应使用全局命名空间中的版本应用需要调用
sourceMapSupport.install()
来设置源映射支持@remix-run/react
删除
unstable_shouldReload
,增加shouldRevalidate
@remix-run/serve
如果3000端口被占用且未指定PORT,则
remix-serve
将选择一个可用的端口集成手动模式
删除未记录的
createApp Node API
在
remix-serve
中保留动态imports以供外部bundle使用@remix-run/vercel
@remix-run/vercel
适配器已被删除,推荐使用Vercel官方提供的功能create-remix
停止传递
isTypeScript
给remix.init
脚本remix
删除魔法
exports
(3)破坏类型变化
- 从
future.v2_meta
类型中删除了V2_
前缀,因为它们现在是默认行为。
V2_MetaArgs
->MetaArgs
V2_MetaDescriptor
->MetaDescriptor
V2_MetaFunction
->MetaFunction
V2_MetaMatch
->MetaMatch
V2_MetaMatches
->MetaMatches
V2_ServerRuntimeMetaArgs
->ServerRuntimeMetaArgs
V2_ServerRuntimeMetaDescriptor
->ServerRuntimeMetaDescriptor
V2_ServerRuntimeMetaFunction
->ServerRuntimeMetaFunction
V2_ServerRuntimeMetaMatch
->ServerRuntimeMetaMatch
V2_ServerRuntimeMetaMatches
->ServerRuntimeMetaMatches
- 以下类型已进行调整,更偏向于使用
unknown
而不是any
,并与底层的React Router类型保持一致: 将
useMatches()
的返回类型从RouteMatch
改名为UIMatch
将
LoaderArgs
/ActionArgs
改名为LoaderFunctionArgs
/ActionFunctionArgs
将
AppData
的类型从any
改为unknown
将
Location["state"]
(useLocation.state
)的类型从any
改为unknown
将
UIMatch["data"]
(useMatches()[i].data
)的类型从any
改为unknown
将
UIMatch["handle"]
(useMatches()[i].handle
)的类型从{ [k: string]: any }
改为unknown
将
Fetcher["data"]
(useFetcher().data
)的类型从any
改为unknown
MetaMatch.handle
(在meta()
函数中使用)的类型从any
改为unknown
AppData
/RouteHandle
不再导出,因为它们只是unknown
的别名
新增功能
- 新的
create-remix
命令行界面工具
- 最显著的改变是,不再使用下拉菜单选择模板/堆栈,而是使用
--template
参数和不断增长的可用模板列表。 - 新增
--overwrite
参数 - 支持
bun
包管理器
- 通过
build.mode
检测构建模式 - 支持通过
serverNodeBuiltinsPolyfill.globals
/browserNodeBuiltinsPolyfill.globals
来对Node全局对象进行polyfill
- 新的
redirectDocument
实用工具,通过重新加载文档实现重定向 - 在
meta
参数中添加error
,以便可以渲染错误等 unstable_createRemixStub
现在支持在stubbed Remix路由上添加meta/links
函数unstable_createRemixStub
不再支持在路由上使用element/errorElement
属性。必须使用Component/ErrorBoundary
与从Remix路由模块导出的内容匹配。
其他更新
- Remix现在在内部使用React Router的
route.lazy
方法在导航时加载路由模块。 - 删除了
@remix-run/node
中的atob/btoa
polyfills,改用内置版本。 - 将
@remix-run/dev
包与@remix-run/css-bundle
包的内容解耦。 - 现在,
@remix-run/css-bundle
包的内容完全由Remix编译器管理。尽管仍然建议Remix依赖项共享相同的版本,但这个变化确保在升级@remix-run/dev
而不升级@remix-run/css-bundle
时没有运行时错误。 remix-serve
现在将选择一个空闲的端口(如果3000端口被占用)。
- 如果设置了PORT环境变量,r
emix-serve
将使用该端口。 - 否则,
remix-serve
将选择一个空闲的端口(除非3000端口已被占用)。
- 更新的依赖项:
react-router-dom@6.16.0
@remix-run/router@1.9.0
@remix-run/web-fetch@4.4.0
@remix-run/web-file@3.1.0
@remix-run/web-stream@1.1.0
React Server Components?
Remix 对于 React Server Components(RSC)的支持计划是积极的。他们希望在Remix v3中添加对RSC的支持,并希望能够展示这项技术在多个框架中的能力。
RSC是一个有趣且强大的功能,但是 Remix v2 是基于当前稳定的React特性构建的,因此 RSC 在 Remix v2 中尚未包含。一旦RSC稳定下来,Remix 将会支持它。
然而,与之前支持的其他React特性相比,“支持RSC”需要更深入的集成。RSC的异步组件与Remix的加载器和组件结合得非常相似,并且Remix在v3中决定摒弃使用第三方库useLoaderData,因此在数据加载方面可能会有所不同。他们希望开发者只需要将现有的加载器代码迁移到新的异步组件中,但需要注意数据依赖的瀑布效应。
Remix团队在今年早些时候的Remix Conf上与React核心团队的成员举办了一个讨论会,讨论了RSC以及如何共同推进这项技术的稳定发布。他们以各种方式帮助准备RSC,并希望能够成功地集成它到Remix中。