React useSyncExternalStore

作用: useSyncExternalStore 是 React 18 中引入的 Hook,用于在 React 组件中安全地订阅外部(非 React)数据源,同时保持与 React 的更新机制同步。它是 useSubscription Hook 的官方替代,为集成如 Redux 或 MobX 这样的外部状态管理库提供了一个标准化的方式,同时支持 React 的并发模式(Concurrent Mode)。

用法: useSyncExternalStore 接受三个参数:

  1. subscribe:这是一个函数,它接收一个监听器(listener callback)。当外部数据源发生变化时,监听器应被调用,提示 React 需要获取新的数据快照。
  2. getSnapshot:一个函数,返回与外部数据源当前状态相对应的值。
  3. getServerSnapshot(可选):仅在服务端渲染(Server-Side Rendering, SSR)中使用的函数,返回与外部数据源当前状态相对应的值。

示例: 假设我们有一个简单的外部数据源 store,它有 subscribegetState 方法:

javascript 复制代码
const store = {
  subscribe(callback) {
    // 订阅变化,当数据更新时调用 callback
  },
  unsubscribe(callback) {
    // 取消订阅
  },
  getState() {
    // 获取当前状态
    return someData;
  }
};

现在,我们可以使用 useSyncExternalStore 来订阅这个 store

javascript 复制代码
import { useSyncExternalStore } from 'react';

function MyComponent() {
  const state = useSyncExternalStore(
    // 订阅函数
    (callback) => {
      store.subscribe(callback);
      return () => store.unsubscribe(callback);
    },
    // 快照获取函数
    () => store.getState()
  );

  // 使用 state 渲染你的组件
  return <div>{state}</div>;
}

使用注意事项:

  1. 性能考虑 :确保 subscribe 函数不会在组件每次渲染时都创建新的订阅,这可能会导致内存泄漏。
  2. 监听器调用 :监听器应该被调用在任何可能导致 getSnapshot 返回值变化的情况下,以确保组件能够重新渲染。
  3. 避免副作用getSnapshotgetServerSnapshot 应该是纯函数,它们不应有副作用,也不应更改应用状态。
  4. 并发模式兼容性 :当使用 React 的并发模式时,useSyncExternalStore 确保组件状态与外部数据源同步,并减少不一致的可能性。
  5. SSR 兼容性 :确保在服务端渲染环境中提供 getServerSnapshot 函数,并处理数据获取和同步,以避免客户端和服务器的渲染不一致。

useSyncExternalStore 提供了一种标准化的方式来确保 React 组件与外部数据源保持同步,同时兼容 React 的新特性和并发模式。正确使用此 Hook 可以帮助开发者避免与状态订阅相关的常见陷阱。

相关推荐
几何心凉3 小时前
没有万能模型:我用 AiiOnly Token Plan,把多款大模型的长处拼进同一个项目
前端
kyriewen3 小时前
Claude Code 的额度今天缩水了17%——官方公告上写的是"永久提高25%"
前端·ai编程·claude
雪芽蓝域zzs4 小时前
vue解构平铺VS对象包裹
前端·javascript·vue.js
风骏时光牛马4 小时前
从零到实战,完整AI学习路线
前端
三十而立洋5 小时前
深入理解 Monorepo:子包安装依赖
前端·前端工程化
IT_陈寒5 小时前
Java Stream处理大集合,我的内存怎么就炸了
前端·人工智能·后端
Captaincc5 小时前
AI 用量桌面端-桌面宠物自定义指南
前端·人工智能
OpenTiny社区6 小时前
码力全开,智启前端新生态|OpenTiny 登陆华为全联接大会2026
前端·github
妙码生花6 小时前
利用AI从零学Go并完成实战项目,完工总结:目录结构
前端·后端·go
妙码生花6 小时前
利用AI从零学Go并完成实战项目,完工总结:商业级开源产品定位和核心特性介绍
前端·后端·go