首页 > web前端 > js教程 > 正文

在React和TypeScript中高效展示异步函数返回的字符串

聖光之護
发布: 2025-11-14 18:24:45
原创
974人浏览过

在react和typescript中高效展示异步函数返回的字符串

在React应用中,当需要在列表渲染(如`map`函数)内部显示通过异步函数获取的数据时,直接调用异步函数会导致类型不匹配错误。本文将详细介绍如何通过创建独立的子组件,并结合`useState`和`useEffect`钩子,优雅地解决这一问题,确保异步数据能够正确、响应式地在组件中展示。

异步数据展示的挑战:为什么直接调用不起作用?

在React组件中,我们经常需要从外部源(如数据库、API)获取数据。当这些数据需要在一个列表(例如通过Array.prototype.map()方法渲染的任务列表)中为每个项独立获取时,直接在渲染逻辑中调用异步函数会遇到问题。

考虑以下场景:我们有一个任务列表,每个任务包含一个userID。我们希望显示每个任务的创建者用户名,而这个用户名需要通过异步函数getUserName(userID)从数据库中获取。

// 假设这是父组件的渲染部分
return (
    <>
        {taskList?.map((task: Task) => (
            <Card key={task.id}>
                <h3>{task.title}</h3>
                <p>Created By: {getUserName(task.userID)}</p> {/* 问题所在 */}
            </Card>
        ))}
    </>
);

// getUserName 函数示例
const getUserName = async(userID: string) : Promise<string> => {
    // 假设这里是调用Firebase或其他数据库获取用户名的逻辑
    const userDocRef = doc(db, "users", userID);
    const userSnapshot = await getDoc(userDocRef);
    if (userSnapshot.exists()) {
        return (userSnapshot.data() as UserData).name;
    }
    return "未知用户";
};
登录后复制

上述代码中,getUserName(task.userID)会返回一个Promise<string>类型的值,而不是一个可以直接渲染的ReactNode(如string、number、JSX.Element等)。因此,React会抛出类似Type 'Promise<string>' is not assignable to type 'ReactNode'.ts(2322)的类型错误。

此外,React的渲染流程是同步的。在map函数内部直接调用异步函数,即使没有类型错误,也无法等待异步操作完成再进行渲染,因为useState等钩子不能在循环或条件语句中调用。

解决方案:封装独立的异步数据展示组件

解决此问题的最佳实践是创建一个独立的子组件,专门负责获取并显示其自身的异步数据。这个子组件将利用React的useState和useEffect钩子来管理异步操作的状态和生命周期。

怪兽AI数字人
怪兽AI数字人

数字人短视频创作,数字人直播,实时驱动数字人

怪兽AI数字人 44
查看详情 怪兽AI数字人

1. 创建 UsernameDisplay 子组件

首先,我们创建一个名为UsernameDisplay的组件,它接收userID作为props。

// UsernameDisplay.tsx
import React, { useState, useEffect } from 'react';
import { doc, getDoc } from 'firebase/firestore'; // 假设使用Firebase Firestore
import { db } from './firebaseConfig'; // 假设你的Firebase配置在此文件

interface UserData {
    name: string;
    // ... 其他用户数据属性
}

interface UsernameDisplayProps {
    userId: string;
}

const UsernameDisplay: React.FC<UsernameDisplayProps> = ({ userId }) => {
    const [username, setUsername] = useState<string>('加载中...'); // 初始状态为加载中

    useEffect(() => {
        let isMounted = true; // 用于处理组件卸载后异步操作完成的情况

        const fetchUsername = async () => {
            try {
                const userDocRef = doc(db, "users", userId); // 假设用户数据存储在'users'集合中
                const userSnapshot = await getDoc(userDocRef);

                if (isMounted && userSnapshot.exists()) {
                    const userData = userSnapshot.data() as UserData;
                    setUsername(userData.name);
                } else if (isMounted) {
                    setUsername('未知用户'); // 用户不存在
                }
            } catch (error) {
                if (isMounted) {
                    console.error("获取用户名失败:", error);
                    setUsername('获取失败'); // 处理错误情况
                }
            }
        };

        if (userId) { // 只有当userId存在时才进行数据获取
            fetchUsername();
        } else {
            setUsername('N/A'); // 如果没有userId
        }

        return () => {
            isMounted = false; // 组件卸载时标记为false,避免状态更新
        };
    }, [userId]); // 依赖项数组,当userId变化时重新运行effect

    return <span>{username}</span>;
};

export default UsernameDisplay;
登录后复制

组件解析:

  • useState<string>('加载中...'): 定义一个状态变量username来存储获取到的用户名。初始值设为“加载中...”,可以在数据加载期间提供用户反馈。
  • useEffect(() => { ... }, [userId]): 这是一个副作用钩子,用于执行异步数据获取。
    • 它会在组件首次渲染后以及userId发生变化时运行。
    • fetchUsername是一个异步函数,负责调用Firebase(或任何数据源)来获取用户名。
    • isMounted标志用于防止在组件卸载后尝试更新状态,这是一种常见的内存泄漏防护模式。
    • return () => { isMounted = false; } 是useEffect的清理函数,在组件卸载时执行。
  • 依赖项数组 [userId]: 确保只有当userId发生变化时,useEffect中的数据获取逻辑才会重新执行,避免不必要的重复请求。

2. 在父组件中集成 UsernameDisplay

现在,我们可以在父组件的map函数中安全地使用UsernameDisplay组件:

// 父组件 TaskList.tsx
import React from 'react';
import { Container, Card, Button } from 'react-bootstrap'; // 假设使用React Bootstrap
import UsernameDisplay from './UsernameDisplay'; // 导入我们创建的组件
import { Task } from './types'; // 假设Task类型定义在此文件
import { deleteTask } from './firebaseUtils'; // 假设删除任务的函数

interface TaskListProps {
    taskList: Task[];
}

const TaskList: React.FC<TaskListProps> = ({ taskList }) => {
    return (
        <Container style={{ width: 'auto', border: 'solid 0.2rem', borderRadius: '2rem', marginTop: '2rem', padding: '3rem' }}>
            <h1>任务列表</h1>
            {taskList?.map((task: Task) => (
                <Card key={task.id} style={{ width: '30rem', padding: '2rem', marginBottom: '1rem' }}>
                    <h3>{task.title}</h3>
                    <p>{task.description}</p>
                    <p>{task.timeCreated.toDate().toDateString()}</p>
                    <p>
                        创建者: <UsernameDisplay userId={task.userID} /> {/* 在这里使用子组件 */}
                    </p>
                    <Button variant="danger" onClick={() => deleteTask(task, task.id)}>删除任务</Button>
                </Card>
            ))}
        </Container>
    );
};

export default TaskList;
登录后复制

通过这种方式,每个Card内部的UsernameDisplay组件都会独立地管理其用户名的获取和显示。当UsernameDisplay组件挂载时,它会触发useEffect中的异步请求;一旦数据返回,它会更新自己的username状态,从而导致自身重新渲染并显示正确的用户名。

注意事项与最佳实践

  1. 加载状态和错误处理: 在UsernameDisplay组件中,我们已经包含了“加载中...”和“获取失败”的状态。这对于提升用户体验至关重要。你可以进一步优化,例如显示一个加载指示器(Spinner)或更详细的错误信息。
  2. 避免不必要的请求: 确保useEffect的依赖项数组设置正确。如果userId不变,则无需重新获取数据。
  3. 组件卸载防护: isMounted标志是处理异步操作的经典模式,可以避免在组件已从DOM中移除后尝试更新其状态,从而防止潜在的内存泄漏和错误。
  4. 数据缓存: 如果有大量任务,且许多任务由同一用户创建,那么频繁地为相同的userID发起数据库请求可能会效率低下。可以考虑在父组件或更高级别使用一个缓存机制(如Map对象或React Query、SWR等库)来存储已获取的用户名,避免重复请求。
  5. 类型安全: 使用TypeScript接口(如UserData、UsernameDisplayProps)可以确保代码的类型安全和可维护性。
  6. 可测试性: 将数据获取逻辑封装在独立的组件中,使得测试更加容易。你可以模拟UsernameDisplay组件的props,并检查其渲染输出。

总结

在React和TypeScript中处理列表渲染内部的异步数据展示,核心思想是将异步数据获取逻辑封装到一个独立的子组件中。这个子组件利用useState管理数据状态,useEffect处理副作用(如数据请求),从而实现数据加载、显示和更新的响应式管理。这种模式不仅解决了直接在map中渲染Promise的类型问题,也提升了组件的模块化、可读性和性能。

以上就是在React和TypeScript中高效展示异步函数返回的字符串的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号